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FOREWORD 


四 十 不 惑 ,创新 不 止 


从 飞 铝 传 书 到 手机 沟通 ,从 钻 木 取 火 到 核能 发 电 , 从 日 行 千 里 到 探索 太空 …… 曾 经 遥 不 
可 及 的 梦想 如 今 已 经 变 为 现实 ,有 些 甚至 超出 了 人 们 的 想象 ,而 所 有 这 一 切 都 离 不 开 科 技 创 
新 的 力量 。 

对 于 微软 而 言 ,创新 是 我 们 的 灵魂 ,是 我 们 矢志 不 渝 的 信仰 。 不 断 变革 的 操作 系统 ,日 
益 完 善 的 办 公 软 件 ,预见 未 来 的 领先 科技 ……40 多 年 来 ,在 创新 精神 的 指引 下 ,我 们 取得 了 
辉煌 的 成 绩 ,引领 了 高 科技 领域 的 突破 性 发 展 。 

IT 行业 不 墨守成规 ,只 尊重 创新 。 过 往 的 成 就 不 能 代表 未 来 的 成 功 ,我 们 将 继续 研 三 
前 行 。 如 果 说 ,以 往 诸如 个 人 计算 机 ,平板 电脑 ,手机 和 可 穿戴 设备 的 发 明 大 都 是 可 见 的 , 那 
么 ,在 我 看 来 ,未 来 的 创新 和 突破 将 会 是 无 形 的 . “隐形 计算 ”就 是 微软 的 下 一 个 大 事件 。 让 
计算 归于 “无 形 ”, 让 技术 服务 于 生活 ,是 微软 现在 及 未 来 的 重要 研发 方向 之 一 。 

当 计 算 来 到 云端 后 , 便 隐 于 无 形 . 能 力 却 变 得 更 加 强大 ; 当 机 器 学 习 足 够 先进 ,人 们 在 
尽 享 科技 带 来 的 便利 的 同时 却 觉 察 不 到 计算 过 程 的 存在 ; 当 人 们 只 需 通过 声音 、 手 势 就 可 
以 与 周边 环境 进行 交互 ,计算 机 也 将 从 人 们 的 视线 中 消失 。 正 如 著名 科幻 作家 亚 瑟 . 查 尔 
斯 . 克拉克 所 说 :“ 真 正 先 进 的 技术 ,看 上 去 都 与 魔法 无 异 .” 

技术 是 通 往 未 来 的 钥匙 ,要 实现 “隐形 计算 ”, 人工 智能 技术 在 这 其 中 起 着 关键 作用 。 近 
几 年 ,得 益 于 大 数据 ` 云 计算 、 精 准 算法 .深度 学 习 等 技术 取得 的 进展 .人 工 智能 研究 已 经 发 
展 到 现在 的 感知 ,甚至 认 知 阶段 。 未 来 ,要 实现 真正 的 人 机 互动 ,个 性 化 的 情感 沟通 ,计算 机 
视觉 ,语音 识别 ,自然 语言 将 是 人 工 智能 领域 进一步 发 展 的 突破 口 及 热门 的 研究 方向 。 

2015 年 7 月 发 布 的 Windows 10 是 微软 在 创新 路 上 写 下 的 完美 注脚 。 作 为 史上 第 一 个 
真正 意义 上 跨 设备 的 统一 平台 ,Windows 10 为 用 户 带 来 了 无 颖 衔接 的 使 用 体验 ,而 智能 人 
工 助理 Cortana Windows Hello 生物 识别 技术 的 加 入 ,让 人 机 交互 进入 了 一 个 新 层次 。 
Windows 10 也 是 历史 上 最 好 的 Windows、 最 有 中 国 印记 的 Windows, 不 但 有 针对 中 国 本 土 
的 大 量 优化 ,还 有 海量 的 中 国 应 用 。Windows 10 是 一 个 具有 里 程 碑 意 义 的 跨 时 代 产 品 ,更 
是 微软 崇尚 创新 的 具体 体现 ,这 种 精神 渗透 在 每 一 个 微软 员工 的 血液 之 中 ,激励 着 我 们 “ 予 
力 全 球 每 一 人 、 每 一 组 织 成 就 不 凡 ”。 
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四 十 不 惑 的 微软 对 前 方 的 创新 之 路 看 得 更 加 清晰 , 走 得 也 更 加 坚定 。 希 望 这 套 从 书 不 
仅 成 为 新 时 代 中 微软 前 行 的 见证 ,也 能 够 助 中 国 的 开发 者 一 臂 之 力 , 共 同 繁荣 我 们 的 生态 系 
统 ,绽放 更 多 精彩 的 应 用 ,成 就 属于 自己 的 不 凡 。 


沈 向 洋 
微软 全 球 执行 副 总 裁 


主人 -= 
有 后 
PREFACE 


经 过 10 多 年 的 发 展 , Microsoft .NET Framework 已 经 相当 成 熟 ,拥有 强大 的 类 库 与 可 
视 化 框架 ,融合 了 许多 新 技术 。 在 Windows 平台 上 ,从 桌面 应 用 到 Web 应 用 都 能 完 
胜任 。 

.NET Core 是 在 原 . NET 框架 的 基础 上 开发 的 新 一 代 开 源 项 目 , 人 们 期 待 已 久 的 
.NET 跨 平 台 终 于 实现 (基于 . NET Core 开发 的 应 用 程序 可 以 运行 在 Windows、 Linux、 
Mac OSX 等 操作 系统 上 )。 NET Core 项 目 由 微软 官方 团队 、 第 三 方 开 发 团队 及 社区 用 户 共 
同 维护 。. NET Core 从 原 有 的 . NET Framework 抽取 出 最 基础 .最 核心 的 API 重新 开发 , 作 
为 . NET 的 新 标准 发 布 ,第 三 方 开 发 人 员 可 以 在 此 标准 上 进行 自由 扩展 。 

本 书 所 有 内 容 均 以 实例 的 形式 呈现 ,容易 上 手 。 每 个 实例 都 包含 两 部 分 内 容 :【 导 语 】 
部 分 主要 对 实例 中 要 用 到 的 核心 知识 点 进行 介绍 ;区 操作 流程 了 部 分 详细 讲述 完成 实例 项 目 
的 步骤 ,读者 可 以 直接 动手 实践 ,亲自 体验 编程 的 乐趣 

本 书 内 容 分 为 三 篇 : 

第 一 篇 ”基础 知识 。 涉 及 开发 环境 的 搭建 ,基础 类 型 ,流程 控制 .常用 集合 .LINQ 语法 
和 面向 对 象 思想 等 内 容 。 

第 二 篇 ”技术 进 阶 。 强 化 编程 技能 ,此 部 分 的 实例 包括 文件 与 目录 操作 、 基 础 1/O、 序 
列 化 / 反 序 列 化 ,网 络 与 异步 编程 .反射 与 加 密 算法 应 用 等 内 容 。 

第 三 篇 ASP.NET Core。 此 部 分 主要 包括 与 Web 开发 相关 的 实例 ,重点 涉及 Web 
Host 初始 化 、 中 间 件 依赖 注入 、 应 用 配置 .EF Core 等 关键 知识 。 

笔者 曾 写 过 与 C# 编程 相关 的 书 ,写作 此 书 的 想法 是 源 于 几 位 网 友 在 微 博 私 信 中 的 提 
问 ,经 过 一 番 蔚 酌 ,我 认为 有 必要 编写 一 本 与 . NET Core 有 关 的 书 ,毕竟 . NET Core 作为 全 
新 的 跨 平 台 项 目 , 存 在 不 少 新 的 特性 。 不 过 本 书 中 未 使 用 大 篇 幅 讲解 的 叙述 方式 ,而 是 采用 
以 单独 实例 驱动 为 主 ,以 知识 前 述 为 辅 的 方式 ,重点 在 于 调动 读者 积极 上 机 实战 的 兴趣 。 经 
常 有 初学 编程 的 朋友 问 我 : 为 什么 看 书 的 时 候 感觉 自己 学 会 了 ,但 一 融 代 码 就 什么 都 忘 了 ? 
其 实 , 没 有 人 天 生 就 会 写 代 码 ,之 所 以 会 有 这 种 遗忘 现象 的 发 生 ,说 到 底 是 练 得 太 少 了 ,总 觉 
得 书 上 的 例子 很 简单 ,而 不 愿意 动手 去 敲 一 遍 。 

.NET Core 作为 开源 项 目 , 可 能 会 有 许多 扩展 项 目 ,涉及 内 容 较 广 ,由 于 篇 幅 与 作者 的 
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水 平 有 限 , 本 书 不 能 覆盖 所 有 的 应 用 领域 , 仅 精 选 出 与 . NET Core 主体 框架 关系 密切 且 较 
为 实用 的 实例 进行 演示 ,提供 给 大 家 作为 参考 。 

最 后 ,感谢 各 位 同仁 与 广大 网 友 对 我 的 支持 ,也 感谢 清华 大 学 出 版 社 , 我 们 已 经 合作 出 
版 过 多 种 图 书 。 


周 家 安 
2019 年 7 月 
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实例 368 ”访问 静态 文件 … 
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第 17 章 应 用 配置 与 数据 库 访问 


17.1 配置 应 用 程序 . gel 

实例 371 自 定 义 环境 变量 的 命名 前 组 
实例 372 ”使 用 JSON 文件 进行 配置 …… 
实例 373 ” 自 定义 命令 行 参 数 映 射 ……… 
实例 374 ”使 用 内 存 中 的 配置 源 …… 

17.2 选项 类 …… ee 
实例 375 选项 类 的 使 用 方法 ppp 
实例 376 ”使 用 JSON 文件 来 配置 选项 类 …… 
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第 一 篇 基础 知识 


本 篇 内 容 侧 重 基 础 知识 的 巩固 ,通过 学 习 各 章 的 实例 ,读者 能 够 党 
握 以 下 内 容 。 

。 搭建 与 配置 开发 环境 ; 

。 使 用 dotent 命令 行 工 具 或 者 Visual Studio 开发 环境 管理 应 用 

程序 项 目 ; 

。 代码 表达 式 与 流程 控制 ; 

。 日 期 .数字 与 字符 串 的 处 理 技巧 ; 

。 理解 面向 对 象 编程 的 基本 思想 ; 

。 LINQ 语法 与 常见 集合 的 使 用 。 


搭建 开发 与 测试 环境 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 

。 Visual Studio 开发 环境 的 安装 ; 

。 .NET Core SDK 的 安装 ; 

， 在 Linux 操作 系统 中 搭建 测试 环境 。 


1.1 在 Windows 上 安装 开发 环境 


实例 1 安装 Visual Studio 


【导语 】 

由 于 Visual Studio 支持 的 跨 平台 开发 功能 越 来 越 完善 ,如 果 采 取 传 统 的 离线 包 安 装 方 
式 , 不 仅 占用 人 硬盘 空间 大 ,也 不 便于 更 新 ,因此 笔者 推荐 在 线 安装 。 在 安装 Visual Studio 的 
时 候 , 读 者 可 以 根据 自己 的 需要 选择 安装 组 件 ,不 必要 完全 安装 。 

【操作 流程 】 

步骤 1: 打开 网 页 浏览 器 ,浏览 官方 主页 https: //www. visualstudio. com/zh-hans, 然 
后 选择 适合 自己 的 Visual Studio 版 本 进行 下 载 ,如 图 1-1 所 示 。 

对 于 个 人 开发 者 或 者 小 型 开发 团队 来 说 ,可 以 优先 选用 Community 版 本 ,此 版 本 是 完 
全 免费 的 ,而 且 包 含 Visual Studio 的 完整 功能 。 

步骤 2: 下 载 的 文件 是 一 个 专门 的 安装 器 。 双 击 “ 运 行 ”, 会 启动 Visual Studio Installer 
组 件 。 如 果 是 首次 运行 ,或 者 查找 到 有 新 版 本 ,组 件 启动 时 会 有 一 个 初始 化 的 过 程 , 请 耐心 
等 待 初始 化 完成 。 

步骤 3: 安装 程序 初始 化 完成 后 ,会 提示 用 户 选择 要 安装 的 模块 ,此 时 在 “工作 负载 ? 标 
签 页 中 会 列 出 各 种 项 目 类 型 。 本 书 只 需要 安装 “. NET Core 跨 平台 开发 "模块 ,如 果 读 者 需 
要 开发 其 他 类 型 的 应 用 项 目 , 可 以 按 需 选择 ,如 图 1-2 所 示 。 

窗口 右 方 的 “摘要 ”页 中 显示 即将 要 进行 安装 的 组 件 的 详细 列表 。“ 可 选 ”" 下 面 的 内 容 并 
非 必 须 安装 ,用 户 可 以 自由 处 理 , 如 图 1-3 所 示 。 

步骤 4: 选 好 要 安装 的 组 件 后 , 单 击 窗口 右 下 方 的 “安装 ”按钮 开始 在 线 下 载 需 要 的 安装 
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Visual Studio 下 载 


Visual Studio Visual Studio Visual Studio Visual Studio 
Community 2017 Professional 2017 Enterprise 2017 Code 
适用 于 学 生 、 开 源 和 个 人 适用 于 小 型 团队 的 专业 开 满足 所 有 规模 大 小 的 团队 重新 定义 了 Code 编辑 . 


开发 人 员 的 功能 完备 的 免 发 人 员工 具 、 服 务 和 订阅 的 要 求 质量 和 规模 的 端 到 免费 开 i 在 任何 位 
费 IDE 权益 端 解决 方案 


免费 下 载 二 免费 试用 二 免费 试用 二 


发 行 说 明和 文档 > 发 行 说 明和 文档 > 发 行 说 明和 文档 > 
三 [] 中 


下 载 Visual Studio 预览 版 二 比较 Visual Studio 各 个 版 本 全 如 何 两 线 安装 多 


图 1-1 选择 合适 的 版 本 下 载 


工作 负载 单个 组 件 语言 包 


使 用 Javascript 的 移动 开发 | 使 用 C++ 的 移动 开发 
使 用 用 于 Apache Cordova 的 工具 生成 Android 、ios 和 -J 使 用 C++ 对 i5、Android 或 Windows 生成 器 平台 应 用 程 
UWP 应 用 。 序 。 


办 A 使 用 C++ 的 游戏 开发 
充分 使 用 C++ 生成 由 DirectX、Unreal 或 Cocos2d 提 供 技 
术 支 持 的 专业 游戏 。 
其 人 工具 集 (3) 
四 Visual Studio 扩展 开发 A 村 用 rs 的 Ua 开业 


加 为 Visual Studio 创建 加 载 项 和 扩展 ， 包 括 新 命令 、 代 码 分 析 创建 种 也 式 在 Linux 环境 中 运行 的 应 用 程序 。 
器 和 工具 窗口 。 


中) .NET Core 跨 平台 开发 
使 用 .NET Core 、ASPJNET Core、HTML/JavaScript 和 也 括 


Docker 支持 的 容器 生成 跨 平 台 应 用 程序 。 


图 1-2 选择 要 安装 的 模块 


包 。 整 个 安装 过 程 都 是 自动 完成 的 ,具体 安装 时 间 取 决 于 用 户 前 面 所 做 的 选择 。 
步骤 $: 待 安装 顺利 完成 后 ,就 可 以 关闭 Visual Studio Installer 窗口 。 由 于 网 络 不 稳 
定 或 其 他 原因 导致 安装 过 程 没有 顺利 完成 ,可 以 重新 运行 一 遍 安装 程序 ,直到 安装 完成 。 
步骤 6: 此 时 ,通过 Windows 系统 的 “开始 ”菜单 找到 Visual Studio < 版 本 号 > 图 标 ,就 
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捅 要 
》Visual Studio 核心 编辑 器 
v .NET Core 跨 平台 开发 
已 包含 
v .NET Core 2.0 开发 工具 
Y ,NET Framework 4.6.1 开发 工具 
Y ASP.NET 和 Web 开发 工具 先决 条 件 
Y Developer Analytics Tools 


可 选 
适用 于 Web 开发 的 云 工具 
IntelliTrace 
.NET 分 析 工 具 
Live Unit Testing 
快照 调试 程序 
NET Core 10 - 1.1 Web 版 开发 工具 


图 1-3 必 选 组 件 与 可 选 组 件 列 表 
可 以 运行 Visual Studio 开发 环境 了 。 


注意 : 初次 运行 Visual Studio 的 时 候 ,开发 环境 会 进行 初始 化 工作 。 然 后 需要 注册 一 个 
Microsoft 账号 进行 登录 ,以 获取 授权 许可 证 ,许可 证 的 获取 是 完全 免费 的 ,并 且 每 个 
月 会 自动 更 新 。 


实例 2 修复 Visual Studio 


【导语 】 

在 实际 开发 过 程 中 ,有 时候 会 遇 到 Visual Studio 无 法 正常 使 用 的 情况 ,可 能 是 某 些 关 
键 性 数据 损坏 造成 的 ,也 可 能 是 安装 了 不 兼容 的 扩展 而 引起 的 。 此 时 ,可 以 通过 "修复 ?功能 
来 重新 安装 开发 环境 。 

【操作 流程 】 

步骤 1: 从 “开始 ”菜单 中 找到 Visual Studio Installer, 单 击 “ 运 行 ” 按 钮 。 

步骤 2: 在 已 安装 的 版 本 列表 中 , 单 击 “ 更 多 ...” 下 三 角 按钮 ,并 从 弹出 的 菜单 中 执行 “ 修 
复 ” 命 令 , 如 图 1-4 所 示 。 

EJ | Visual Studio Enterprise 2017 


15.6.4 
满足 任何 规模 团队 的 生产 效 京 和 协调 性 需求 的 Microsoft 
DevOps 解决 方案 
发 行 说 明 
修改 启动 更 多 = 
修复 
知 载 


图 1-4 选择 修复 操作 
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步骤 3: 此 时 安装 程序 会 重新 安装 Visual Studio ,请 耐心 等 待 安装 完成 。 

如 果 使 用 以 上 方法 仍 无 法 修复 ,可 以 执行 以 下 方案 。 

步骤 4: 以 管理 员 身 份 运行 “命令 行 提示 符 ” 窗 口 (CMD), 然 后 定位 到 Visual Studio 
Installer 的 安装 路 径 , 例 如 C: \Program Files (x86)\Microsoft Visual Studio\Installer\ 
resources\app\layout ,执行 命令 InstallCleanup -i。 由 于 -i 参数 是 默认 选项 ,因此 可 以 直接 
执行 InstallCleanup。 

步骤 5: 正在 对 Visual Studio 安装 信息 进行 清理 。 

步骤 6: 安装 信息 清理 完成 后 ,InstallCleanup 程序 会 自动 退出 。 此 时 可 以 查看 Visual 
Studio 的 安装 目录 (例如 C: \Program Files (x86)\IMicrosoft Visual Studio\< 版 本 号 >) 是 
否 已 清空 ,如 果 里 面 还 有 内 容 , 请 手动 删除 。 

步骤 7: 再 次 运行 Visual Studio Installer ,重新 安装 一 遍 。 

步骤 8: 此 时 ,Visual Studio 就 能 正常 运行 了 。 


1.2 在 Linux 操作 系统 中 配置 测试 环境 


实例 3 启用 Windows 上 的 Linux 子 系统 


【导语 】 

要 在 Linux 操作 系统 上 运行 和 测试 . NET Core 应 用 程序 ,用 户 不 需要 安装 双 操 作 系 
统 , 也 不 需要 措 建 虚拟 机 ,Windows 10 操作 系统 支持 Linux 子 系统 。Linux 子 系统 不 仅 可 
以 执行 大 多 数 Linux 命令 ,而 且 可 以 直接 访问 Windows 目录 和 文件 ,因为 它 已 经 集成 到 
Windows 操作 系统 的 功能 中 。 

使 用 Bash, 用 户 可 以 像 使 用 “命令 提示 符 ”"(CMD) 程 序 一 样 与 Linux 子 系统 交互 。 目 
前 ,Windows 10 支持 五 个 Linux 发 行 版 ， Ubuntu、SUSE Linux 企业 服务 器 版 、 
OpenSUSE Kali Linux 和 Debian GNU / Linux。 

【操作 流程 】 

步骤 1: 打开 “控制 面板 ”, 找 到 “程序 与 功能 ”, 单 击 “ 启 用 或 关闭 Windows 功能 "选项 。 

步骤 2: 在 功能 列表 中 勾 选 “适用 于 Linux 的 Windows 于 系统 " 复 选 框 ,如 图 1-5 所 示 。 

步骤 3: 单 击 “ 确 定 ” 按 钮 后 ,系统 会 进行 配置 ,配置 完成 后 需要 重新 启动 计算 机 。 这 一 
步 是 必需 的 ,否则 安装 Linux 子 系统 后 无 法 正常 启动 。 

步骤 4: 重新 启动 计算 机 后 ,在 Microsoft Store 中 搜索 关键 字 “Linux”, 在 建议 列表 中 
会 看 到 一 个 名 为 “在 Windows 上 运行 Linux” 的 应 用 集合 , 单 击 选取 。 此 时 会 列 出 前 面 所 提 
到 的 五 个 Linux 发 行 版 (如 图 1-6 所 示 ) ,读者 可 以 选择 自己 喜欢 的 版 本 下 载 。 

步骤 5: 此 处 以 Ubuntu 为 例 , 安 装 完成 后 ,就 可 以 从 系统 的 应 用 列表 中 启动 它 了 。 

步骤 6: 首次 启动 时 ,会 提示 安装 初始 化 ,如 图 1-7 所 示 。 

步骤 7: 等 待 几 分 钟 ,初始 化 成 功 后 会 提示 输入 用 户 名 ,如 图 1-8 所 示 。 
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启用 或 关闭 Windows 功能 四 
若 要 启用 一 种 功能 ， 请 选择 其 复 选 性。 若 要 关闭 一 种 功能 ， 请 清除 其 复 选 
框 。 填充 的 框 表示 仅 启用 该 功能 的 一 部 分 

加 门 XPs 言 者 器 ~ 


田 轩 则 打印 和 文件 服务 

回国 工作 文件 夫 客 户 庙 

由 简单 TCPIP 服务 即 echo、daytime 等 ) 
由 简单 网 络 管 理 协议 (SNMP) 


回国 适用 于 Unux 的 Windows 子 系统 
避 至 保护 的 主机 

口 辐 数据 中 心材 接 

| 远程 关 分 压 窗 AP| 支持 


< 


图 1-5 义 选 Linux 子 系统 功能 


在 Windows 上 运行 Linux 
安装 Linux 发 行 版 并 在 适用 于 Linux 的 Windows 子 系统 (WSL) 上 并 排 运行 它 
们 。 


BY OMENSVE SEeUaTy 


openSUSE SUSE Linux Debian GNU/ ~ KaliLinux 
Leap 42 Enterprise... Linux PPR 
娘娘 二 太 妇女 大 妇 入 交友 


图 1-6 支持 的 Linux 发 行 版 


注意 : 此 处 所 和 输入 的 用 户 名 与 登录 计算 机 的 用 户 名 无 关 , 因 此 可 以 随意 输入 。 


步骤 8: 输入 用 户 名 后 , 按 下 Enter 键 确认 ,接着 输入 密码 ,如 图 1-9 所 示 。 
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图 1-7 Ubuntu 初始 化 


Ubuntu 


1-8 输入 用 户 名 


图 1-9 输入 密码 


注意 : 此 处 输入 的 密码 与 登录 计算 机 时 的 密码 无 关 , 同 样 可 以 随意 输入 。 输 入 密码 需要 再 
次 确认 ( 即 输入 两 次 ) 。 在 输入 密码 的 过 程 中 ,屏幕 上 不 会 有 任何 显示 。 


步骤 9: 现在 Ubuntu 子 系统 可 以 正常 使 用 了 。 
实例 4 设置 root 密码 


【导语 】 

由 于 稍 后 需要 在 Linux 子 系统 中 安装 . NET SDK, 为 了 避免 在 安装 和 配置 过 程 中 因 权 
限 不 够 而 出 现 各 种 错误 ,本 例 将 演示 如 何 为 root 用 户 设置 密码 ,以 便 在 安装 SDK 时 可 以 顺 
利 切换 到 root 上 下 文 。 

【操作 流程 】 

步骤 1: 依然 以 Ubuntu 发 行 版 为 例 ,在 命令 窗口 中 输入 以 下 命令 并 确认 执行 。 


sudo passwd 


步骤 2: 输入 Ubuntu 初始 化 时 设置 的 密码 。 

步骤 3: 输入 为 root 用 户 设置 的 新 密码 (需要 再 次 确认 ) 。 

步骤 4: 输入 su 或 su root 命令 即 可 进入 root 上 下 文 。 

步骤 5: 如 果 想 返回 上 一 次 设置 的 用 户 上 下 文 ,可 以 输入 以 下 命令 。 
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su < 用 户 名 > 


注意 : 当 以 非 root 上 下 文 执行 命令 时 ,在 命令 前 面 加 上 sudo 可 以 允许 普通 用 户 获得 管理 员 
权限 ,这 样 可 以 执行 一 部 分 root 上 下 文才 能 执行 的 命令 (有 些 命令 仍然 需要 登录 root 
上 下 文才 能 执行 ) 。 
车 当前 会 话 为 普通 用 户 ,会 在 计算 机 名 /用 户 名 后 面 显 示 “ 串 ”符号 ; 车 当前 会 话 为 
root, 会 在 计算 机 名 /用 户 名 后 面 显示 “ 提 ” 符 号 。 


实例 5 在 Linux 系统 中 安装 . NET Core SDK 


【导语 】 

尽管 . NET Core 应 用 程序 可 以 编译 为 “ 自 包含 "可 执行 文件 ( 即 不 需要 在 目标 系统 中 安 
装 . NET Core SDK, 复 制程 序 文件 即 可 直接 运行 ) ,但 是 “ 自 包含 ”模式 编译 后 输出 的 文件 体 
积 较 大 .因为 其 中 包含 代码 执行 所 依赖 的 类 库 。 

如 果 目 标 机 器 上 只 运行 一 个 . NET Core 应 用 程序 ,那么 “ 自 包含 ”的 输出 模式 是 可 行 
的 ; 但 是 如 果 目 标 机 器 上 运行 多 个 . NET Core 应 用 程序 ,使 用 * 自 包含 ”输出 模式 并 不 合适 ， 
因为 每 个 应 用 程序 运行 所 依赖 的 类 库 是 相同 的 , 即 存 在 大 量 的 共用 文件 ,这 样 会 产生 许多 不 
必要 的 重复 文件 。 

举 个 例子 ,A 应 用 依赖 类 库 mscorlib. dll,B 应 用 也 依赖 类 库 mscorlib. dll, 并 且 两 个 应 
用 所 依赖 的 类 库 版 本 相同 。 通 常 “ 自 包 含 ”模式 编译 后 会 把 依赖 的 类 库 文件 放 到 应 用 程序 所 
在 的 目录 中 。 假设 A 应 用 输出 到 FA 目录 下 ,B 应 用 输出 到 FB 目录 下 ,如 果 同 时 将 A 应 用 
与 B 应 用 复制 到 同一 台 机 器 上 运行 ,此 时 就 会 产生 两 个 mscorlib. dll 文件 ,一 个 是 /FA/ 
mscorlib. dll, 男 一 个 是 /FB/mscorlib. dll ,两 个 完全 相同 的 文件 重复 存放 ,会 消耗 不 必要 的 
存储 空间 。 这 种 情况 下 ,应 该 考虑 直接 在 目标 机 器 上 安装 . NET Core SDK 或 . NET Core 
Runtime。 

本 实例 将 以 Ubuntu 为 例 来 进行 演示 。 如 果 出 于 开发 和 测试 用 途 ,建议 安装 . NET 
Core SDK 。 

【操作 流程 】 

步骤 1: 为 了 避免 权限 不 够 导致 安装 失败 ,请 输入 su 命令 切换 到 root 上 下 文 。 

步骤 2: 确定 Linux 版 本 与 发 行 代号 ,输入 命令 : 


cat /etc/lsb— release 
cat 命令 的 作用 是 显示 某 个 文件 中 的 内 容 ,/etc/lsb-release 文件 中 存放 着 与 版 本 发 行 相关 的 
信息 。 此 时 会 得 到 如 图 1-10 所 示 的 输出 结果 。 

其 中 ,DISTRIB_RELEASE 是 版 本 号 ,DISTRIB_CODENAME 是 发 行 代号 。 确 定 发 
行 版 本 是 为 了 方便 稍 后 添加 apt source。 
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Ubuntu 16.04.4 LTS 


图 1-10 查看 Linux 发 行 信息 


步骤 3: 导入 相关 密 钥 ,并 存储 在 本 地 文件 中 。 输 入 命令 : 

curl https://packages. microsoft. com/keys/microsoft. asc | gpg —- dearmor > /etc/apt/trusted. 

gpg. d/dotnet. gpg 
curl 命令 从 官方 提供 的 地 址 获取 ASCII 加 密 数 据 , 然 后 通过 gpg-dearmor 命令 将 密 钥 存储 
在 目录 /etc/apt/trusted. gpg.d 下 面 ,表明 该 密 钥 是 可 信任 的 。 

步骤 4: 为 了 能 够 获取 官方 提供 的 应 用 包 , 需 要 为 apt 添加 一 个 source 列表 。 命 令 
如 F: 


echo "deb [arch = amd64] https://packages. microsoft. com/repos/nicrosoft - ubuntu - xenial 一 
prod xenial main" > /etc/apt/sources. list.d/dotnet. list 


请 确保 命令 中 源 地 址 上 的 Linux 发 行 代号 (如 本 例 中 的 xenial) 与 lsb-release 文件 中 显示 的 
发 行 代号 一 致 。 

步骤 5: 输入 以 下 命令 可 以 验证 dotnet. list 文件 是 否 成 功 写 入 。 

cat /etc/apt/sources. list. d/dotnet. list 

如 果 看 到 以 下 输出 ,说 明 dotnet. list 文件 已 成 功 写 入 。 


deb [arch = amd64] https://packages. microsoft. com/repos/microsoft — ubuntu — xenial — prod 


xenial main 


注意 : dotnet. list 只 是 本 例 中 使 用 的 文件 名 ,读者 可 以 根据 自己 偏好 设置 其 他 文件 名 。apt 
命令 在 更 新 sources 时 会 自动 扫描 sources. list. d 目录 下 面 的 文件 。 


步骤 6: 更 新 apt 源 ,以 获取 应 用 包 的 最 新 信息 。 

apt update 

步骤 7: 输入 以 下 命令 可 以 查看 哪些 版 本 的 包 可 用 。 
apt list | grep dotnet — sdk 


apt list 命令 列 出 当前 可 用 的 软件 包 名 称 , 然 后 将 输出 的 列表 传递 给 grep 命令 (通过 
“|” 字 符 ) ,并 使 用 正则 表达 式 进行 查找 。 该 命令 将 查找 名 字 中 包含 “dotnet-sdk” 的 软件 包 ， 
结果 如 图 1-11 所 示 。 

步骤 8: 输入 以 下 命令 ,安装 . NET Core SDK。 
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.0/xenial 2.0.0-1 amd64 
0-preview2-006497/xenial 2.0.0-preview2-006497-1 amd64 
2/xenial 2.0.2-1 amd64 


.3/xenial 2.0.3-1 amd64 

.100/xenial 2.1. 100-1 amdé4 

101/xenial 2.1.101-1 amdé4 

,1027xenial 2.1. 102-1 amd64 

.103/xenial 2. 1. 103-1 amdé4 

.2/xenial 2. 1.2-1 i 

.3/xenial 2.1.3-1 a 

+ 300-previewl-! DoB1 fri a 2.1.300-previewl-008174-1 amd64 
4/xenial 2.1.4-1 amd64 


图 1-11 软件 包 查找 结果 


apt install dotnet 一 sdk 一 2.1.103 

其 中 ,2.1. 103 是 版 本 号 ,具体 可 以 参考 上 一 步 中 apt list 命令 所 列 出 的 有 效 版 本 号 。 
此 时 会 询问 用 户 是 否 继续 安装 , 若 要 安装 ,请 输入 y; 若 想 取 消 安装 ,请 输入 n。 

步骤 9: 等 待 安装 完成 后 ,可 以 输入 以 下 命令 来 检查 是 否 安装 成 功 。 


dotnet — info 


如 果 看 到 相关 的 版 本 号 输出 ,说 明 安 装 已 经 成 功 ; 如 果 出 现 错误 提示 ,请 重新 执行 以 上 
各 步骤 ,确保 完成 安装 


实例 6 在 Linux 系统 中 安装 .NET Core 运行 时 


【导语 】 

如 果 目 标 机 器 用 于 生产 运行 环境 ,可 以 考虑 不 安装 SDK 工具 ,而 仅 安装 运行 时 ,这 样 
.NET Core 应 用 程序 也 能 正常 运行 。 

本 实例 依旧 以 Ubuntu 为 例 进行 演示 。 

【操作 流程 】 

步骤 1: 执行 以 下 命令 可 以 查看 有 效 的 运行 时 版 本 。 


apt list | grep dotnet — runtime— * 


运行 结果 如 图 1-12 所 示 。 


.6/xenial 2.0.6-1 amd64 
. 1. 0-previewl-26216-03/xenial 2. 1.0-preyiewl-26216-03-1 amd64 
mtime-deps-2. 1.0-previewl-26216-03/xenial 2.1.0-previewl-26216-03-1 amd64 


dotne 
dot 
ot 


0.0/xenial 2.0.0-1 amd64 

0. 0-preview2-25407-01/xenial 2.0.0-preview2-25407-01-1 amd64 
0.3/xenial 2.0.3-1 amd64 

.0. 4/xenial 2.0.4-1 amd64 

0.5/xenial 2.0.5-1 amd64 

0. 

1. 


图 1-12 ”有效 的 运行 时 版 本 
步骤 2: 目前 最 新 版 本 为 2. 0. 6( 不 包括 预览 版 ) ,执行 以 下 命令 进行 安装 。 


apt install dotnet 一 runtime 一 2.0.6 
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步骤 3: 如 果 目 标 机 器 上 需要 运行 ASP. NET Core 应 用 程序 ,还 需要 安装 ASP. NET 
Core 运行 时 ,软件 包 名 称 为 aspnetcore-store-< 版 本 号 >。 可 以 执行 以 下 命令 安装 。 
apt install aspnetcore— store 一 2.0.6 
2.0.6 是 目前 最 新 版 本 号 ,以 下 命令 可 以 查看 可 用 的 版 本 号 。 
apt list | grep aspnetcore— store— * 


步骤 4: 安装 完成 后 ,运行 dotnet -info 命令 测试 ,如 果 安 装 成 功 ,会 输出 如 图 1-13 所 
示 的 内 容 。 


图 1-13 测试 安装 结果 


注意 ; ASP. NET Core 运行 时 是 积累 更 新 的 ,新 版 本 与 旧版 本 之 间 可 能 存在 依赖 关系 ,因此 
安装 较 新 版 本 的 运行 时 ,会 同时 安装 旧版 本 的 运行 时 。 通 常 应 该 优先 考虑 安装 最 新 
版 本 的 运行 时 类 库 。 


应 用 程序 项 目 管理 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 

。 dotnet 命令 行 工 具 的 使 用 ; 

。 在 Visual Studio 开发 环境 中 管理 应 用 程序 项 目 ; 
。 发 布 应 用 程序 项 目 。 


2.1 .NET Core 命令 行 工 具 的 使 用 


实例 7 使 用 命令 行 工 具 创建 . NET Core 项 目 


【导语 】 

.NET Core 命令 行 工 具 (CLD 名 称 为 dotnet, 它 可 以 直接 创建 、 修 改 、 编 译 和 发 布 . NET 
Core 应 用 程序 项 目 , 可 谓 是 “麻雀 虽 小 ,五 脏 俱全 ”。 

本 实例 将 演示 使 用 dotnet new 命令 创建 .NET Core 应 用 程序 项 目 。 

【操作 流程 】 

步骤 1: 按 快捷 键 Windows 十 E 打开 系统 的 文件 浏览 器 窗口 ,可 以 在 任意 位 置 新 建 一 
个 目录 ,目录 名 可 随意 设置 ,例如 test。 

步骤 2: 在 文件 浏览 器 窗口 的 地 址 栏 中 输入 
cmd, 按 下 Enter 键 会 打开 “命令 提示 符 ” 窗 口 ,并 且 
工作 目录 会 自动 定位 到 当前 文件 夹 ,如 图 2-1 所 示 。 

步骤 3: 输入 dotnet new 命令 ,可 以 查看 相关 
帮助 信息 ,并 且 会 列 出 已 安装 的 项 目 模 板 , 如 图 2-2 图 2-1 打开 CMD 窗口 
所 示 。 

步骤 4: 输入 dotnet new console 命令 ,创建 一 个 控制 台 应 用 程序 项 目 。 

步骤 5: 项 目 创建 完成 后 ,打开 项 目 所 在 目录 ,可 以 看 到 CLI 工具 生成 了 如 图 2-3 所 示 
的 文件 。 

其 中 ,test. csproj 为 项 目 文 件 ,Program. cs 为 源 代码 文件 ,默认 使 用 C# 编 程 语言 。 

步骤 6: 如 果 和 希望 创建 使 用 VB. NET 编程 语言 的 控制 台 应 用 程序 项 目 , 可 以 加 上 -lang 
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图 2-2 列 出 可 用 的 模板 
参数 ,并 指明 参数 值 为 vb, 即 输入 以 下 语句 。 


dotnet new console - lang wb 


生成 的 项 目 文件 如 图 2-4 所 示 。 


obj obj 
Program.ce 国 Program.vb 
回 testcspraj 加 testvbproj 
图 2-3 生成 的 项 目 文件 图 2-4 生成 VB.NET 代码 文件 


其 中 ,test. vbproj 是 项 目 文件 ,Program. vb 是 VB. NET 源 代码 文件 。 

实例 8 定义 新 项 目的 名 称 与 存放 位 置 

【导语 】 

在 执行 dotnet new 命令 时 ,加 上 -n 或 -name 参数 可 以 为 新 项 目 指 定名 称 ( 若 未 指定 , 则 
使 用 当前 目录 的 名 字 ) ,还 可 以 通过 -o 或 -output 参数 指定 生成 的 项 目 文件 存放 的 目录 。 

【操作 流程 】 

步骤 1: 在 任意 位 置 新 建 一 个 目录 ,命名 为 MyDir。 可 以 使 用 以 下 命令 直接 创建 目录 。 

md MyDir 

步骤 2: 输入 以 下 命令 进入 MyDir 目录 。 

cd MyDir 

步骤 3: 输入 以 下 命令 ,在 MyDir 目录 下 创建 一 个 控制 台 应 用 程序 项 目 ,项 目 名 称 为 
App, 并 把 生成 的 文件 放 到 Sample 子 目录 下 。 

dotnet new console -mn App - o Sample 


步骤 4: 输入 以 下 命令 可 以 查看 生成 的 目录 与 文件 结构 ,如 图 2-5 所 示 。 


第 2 应 用 程序 项 目 管理 | 15 


tree /f 


图 2-5 生成 的 应 用 程序 项 目 文件 与 目录 结构 


实例 9 编译 应 用 程序 项 目 


【导语 】 
执行 dotnet build 命令 ,可 以 在 命令 行 下 编译 并 生成 应 用 程序 项 目 ,其 命令 格式 如 下 。 


dotnet build < 项 目 文件 名 > 


如 果 项 目 文件 名 被 忽略 , 则 默认 会 在 当前 目录 下 查找 可 用 的 项 目 文件 。 
【操作 流程 】 

步骤 1: 打开 “命令 提示 符 ” 窗 口 。 

步骤 2: 在 任意 位 置 新 建 一 个 目录 ,命名 为 MyApps。 


MD MyApps 

步骤 3: 进入 MyApps 目录 。 

cd MyApps 

步骤 4: 创建 一 个 控制 台 应 用 程序 项 目 。 
dotnet new console — n Appl 

步骤 5: 编译 应 用 程序 项 目 。 


dotnet build Appl\App1. csproj 


注意 : 新 创建 的 项 目 被 放 在 名 为 Appl 的 子 目录 下 ,所 以 指定 项 目 文件 名 时 ,必须 是 相对 于 
当前 目录 的 路 径 。 用 户 也 可 以 先 执 行 cd Appl 进入 子 目录 ,再 执行 dotnet build 命 
令 ,因为 项 目 文件 就 在 Appl 目录 下 ,所 以 build 后 面 可 以 省 略 项 目 文件 名 。 


编译 后 的 程序 文件 如 图 2-6 所 示 。 
编译 后 的 程序 文件 位 于 bin\Debug\netcoreapp2.0 目录 下 ,其 中 Appl. dll 文件 是 项 目 
源 代码 编译 后 生成 的 二 进 制 文件 。 
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图 2-6 编译 后 的 程序 文件 


实例 10 编译 项 目的 Release 版 本 


【导语 】 

在 使 用 dotnet build 命令 进行 编译 时 ,附加 -c 或 -configuration 参数 可 以 指定 要 编译 的 
版 本 。 默 认 情 况 下 使 用 Debug 版 本 (调试 版 本 ) ,如果 和 希望 生成 Release 版 本 (发 布 版 本 ), 则 
需要 明确 指定 -c 或 -configuration 参数 为 Release。 

【操作 流程 】 

步骤 1: 打开 “命令 提示 符 " 窗 口 。 

步骤 2: 在 任意 位 置 新 建 一 个 目录 ,命名 为 Test。 


md Test 


步骤 3: 进入 Test 目录。 


cd Test 
步骤 4: 创建 控制 台 应 用 程序 项 目 。 
dotnet new console 


步骤 5: 编译 项 目 ,生成 Release 版 本 。 


dotnet build - c Release 


步骤 6: 编译 后 ,输出 的 Test. dll 文件 就 是 
Release 版 本 ,如 图 2-7 所 示 。 


实例 11 创建 解决 方案 文件 


【导语 】 

解决 方案 通常 由 一 个 或 多 个 项 目 组 成 。 使 用 dotnet new sln 命令 可 以 创建 空白 的 解决 
方案 文件 ,之 后 再 向 解决 方案 文件 添加 或 删除 项 目 。 

【操作 流程 】 

步骤 1: 打开 “命令 提示 符 ” 窗 口 。 

步骤 2: 定位 到 任意 目录 ,并 在 其 中 新 建 一 个 目录 ,命名 为 Demos。 


图 2-7 生成 Release 版 本 


md Demos 


步骤 3: 进入 Demos 目录 。 


图 2-8 Demos 目录 的 结构 


第 2 


cd Demos 
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步骤 4: 创建 一 个 解决 方案 文件 ,命名 为 Happy。 


dotnet new sln 一 n Happy 


步骤 5: 依次 执行 以 下 命令 ,创建 两 个 Web 项 目 ， 


分 别 命 名 为 demol 和 demo2。 


dotnet new web 一 n demol 
dotnet new web 一 D demo2 


步骤 6: 执行 完 上 述 命令 后 ,Demos 目录 的 结构 应 


当 如 图 2-8 所 示 。 


步骤 7: 执行 以 下 命令 ,将 上 面 创建 的 demol 和 


demo2 项 目 添加 到 Happy 解决 方案 中 。 


dotnet sln Happy. sln add demol\demol. csproj demo2\ 


demo2. csproj 


注意 : 由 于 当前 目录 下 只 有 一 个 Happy 解决 方案 ,因此 上 面 命令 中 可 以 省 略 Happy. sln 文 
件 名 , 即 dotnet sln add < 项 目 文件 列表 >。 


步骤 8: 此 时 用 文本 编辑 工具 打开 Happy. sln 文件 ,可 以 


看 到 对 上 面 添加 的 两 个 项 目的 描述 。 


Project ( " {FAE04ECO0 — 301F — 11D3 - BF4B - 00C04F79EFBC}") = 
"demol", "demol\demol1. csproj", "{B65D34D6 - 05B7 — 428F - BAE8 


— 2C36C96DF341}" 
EndProject 


Project(" {FAEO4ECO — 301F — 11D3 - BF4B - 00C04F79EFBC}") = 
"demo2", "demo2\demo2. csproj", "{0D373E8E - 7EEC— 45A4 - BO24 


— 6E2E699C9516}" 
EndProject 


步骤 9: 用 Visual Studio 打开 Happy, 可 以 看 到 解决 方案 
与 两 个 Web 项 目的 关系 ,如 图 2-9 所 示 。 


实例 12 
【导语 】 


枚 举 或 删除 解决 方案 中 的 项 目 


解决 方案 Happy (2 个 项 目 ) 
加 demo1 
全 Connected Services 
£ Propertics 
wwwroot 


PP 池 依 织 项 


ce Program.cs 
Ce Startup.cs 

demo2 

$ Connected Services 
££ properties 

四 wwwroot 

澡 依 壤 硕 


Ce programcs 
ce Startup.cs 


图 2-9 在 Visual Studio 中 


查看 解决 方案 


向 解决 方案 文件 添加 项 目 后 ,可 以 使 用 dotnet sln list 命令 枚 举 该 解决 方案 所 包含 的 项 
目 。 之 后 如 果 不 再 需要 某 些 项 目 , 可 以 使 用 dotnet sln remove 命令 移 除 。 


【操作 流程 】 


步骤 1: 创建 一 个 空 的 解决 方案 文件 。 
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dotnet new sln —n MyApps 
步骤 2: 创建 四 个 项 目 ,其 中 一 个 是 控制 台 应 用 程序 项 目 ,另外 三 个 均 为 类 库 项 目 。 


dotnet new console - n MainApp 

dotnet new classlib —n ExtLibl 
dotnet new classlib — n ExtLib2 
dotnet new classlib — n ExtLib3 


步骤 3: 把 以 上 四 个 项 目 都 添加 到 解决 方案 中 。 


dotnet sln add MainApp\MainApp. csproj ExtLiblNExtLibl. csproj ExtLib2\ExtLib2. csproj ExtLib3\ 
ExtLib3. csproj 


步骤 4: 输入 以 下 命令 可 以 查看 刚才 添加 到 解决 方案 中 的 项 目 列表 。 

dotnet sln list 

输出 结果 如 图 2-10 所 示 。 

步骤 5: 假设 用 户 不 需要 ExtLib2 和 ExtLib3 项 目 了 ,可 以 只 保留 ExtLibl 项 目 。 执 行 
以 下 命令 从 解决 方案 中 移 除 不 需要 的 项 目 。 


dotnet sln remove ExtLib2\ExtLib2. csproj ExtLib3\ExtLib3.csproj 


步骤 6: 执行 完 以 上 命令 后 ,可 以 重新 枚 举 一 下 解决 方案 中 的 项 目 列表 ,确认 指定 的 项 
目 是 否 被 移 除 。 


dotnet sln list 


通过 如 图 2-11 所 示 的 输出 结果 可 以 看 到 ,ExtLib2 和 ExtLib3 两 个 项 目 已 经 被 移 除了 。 


图 2-10 解决 方案 中 的 项 目 列表 图 2-11 被 保留 的 项 目 列表 


注意 : 被 移 除 的 项 目 仅 从 解决 方案 文件 的 项 目 描述 中 删除 ,而 与 项 目 相 关 的 目录 与 文件 并 
不 会 删除 。 


实例 13 ”运行 应 用 程序 

【导语 】 

.NET Core 命令 行 工具 运行 应 用 程序 比较 简单 ,输入 dotnet 去 . dll 文件 名 之 即 可 。 默 
认 情 况 下 ,编译 . NET Core 应 用 程序 后 会 生成 依赖 于 框架 的 版 本 , 即 目标 平台 需要 安装 
. NET Core 运行 时 类 库 后 才能 正常 运行 ,这 样 可 以 大 大 节省 存储 空间 。 因 此 编译 后 仅仅 输 
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出 一 个 扩展 名 为 . dll 的 文件 ,将 生成 的 . dll 文件 提供 给 dotnet 命令 ,运行 框架 会 自动 加 载 并 
寻找 程序 入 口 点 ,找到 入 口 点 后 应 用 程序 就 会 开始 执行 ,直到 退出 。 

【操作 流程 】 

步骤 1: 在 任意 目录 下 ,新 建 一 个 名 为 Demo 的 子 目 录 。 


md Demo 
步骤 2: 进入 Demo 目录。 
cd Demo 


步骤 3: 新 建 一 个 控制 台 应 用 程序 项 目 。 


dotnet new console 

步骤 4: 编译 并 生成 应 用 程序 项 目 。 

dotnet build 

步骤 5: 进入 生成 文件 所 在 的 目录 (默认 在 bin\Debug 子 目录 下 )。 
cd bin\Debug\netcoreapp2. 0 

步骤 6: 运行 应 用 程序 。 

dotnet Demo. dl1 


步骤 7: 若 看 到 控制 台 窗 口 输出 "Hello World!”, 表 示 应 用 程序 已 经 正常 运行 了 。 


注意 : 最 好 对 . dll 文件 名 严格 区 分 大 小 写 , Windows 平台 可 以 忽略 大 小 写 , 但 是 Linux 平台 
是 必须 严格 区 分 大 小 写 的 。 如 本 例 中 的 文件 名 为 Demo. dll, 如 果 在 Linux 系统 上 使 
用 demo. dll, 是 找 不 到 目标 文件 的 。 


2.2 Visual Studio 开发 环境 


实例 14 使 用 Visual Studio 创建 项 目 


【导语 】 

Visual Studio 集成 开发 环境 提供 了 从 开发 到 调试 ,再 到 发 布 的 一 整套 工具 ,可 以 更 高 
效 地 管理 应 用 程序 项 目 。 借 助 该 开发 环境 的 许多 优秀 功能 ,编写 代码 变 得 更 简单 。 

本 例 将 演示 如 何在 Visual Studio 开发 环境 中 新 建 . NET Core 应 用 程序 项 目 。 

【操作 流程 】 

步骤 1: 从 窗口 顶部 的 菜单 栏 中 执行 “文件 ” >“ 新建”>“ 项 目 ” 命 令 , 也 可 以 按 快捷 键 
Cirl+Shift+N, 或 者 单 击 工具 栏 上 的 圈 按 钮 。 
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步骤 2: 此 时 会 打开 “新 建 项 目 ” 对 话 框 ,如 图 2-12 所 示 。 


图 2-12 “新 建 项 目 ” 对 话 框 


步骤 3: 在 对 话 框 左边 的 模板 分 类 中 选择 “Visual C#”>*. NET Core”。 

步骤 4: 对 话 框 中 间 区 域 会 列 出 相应 的 项 目 模板 。 

步骤 5: 选择 “控制 台 应 用 ”, 然 后 在 对 话 框 下 方 的 输入 框 中 输入 项 目 和 解决 方案 的 名 
称 ,以 及 所 存放 的 路 径 。 


注意 : 当 输 入 项 目 名 称 时 ,解决 方案 的 名 称 会 同步 改变 , 即 默 认 情 况 下 ,解决 方案 的 名 称 与 
项 目 名 称 相 同 。 如 果 不 希 望 两 者 的 名 称 相同 ,需要 单独 修改 解决 方案 的 名 称 。 


步骤 6: 输入 完 各 个 参数 后 , 单 击 右 下 角 的 “确定 ”按钮 ,开发 工具 开始 创建 项 目 。 等 待 
项 目 创建 完成 后 ,会 自动 打开 模板 生成 的 Program. cs 文件 。 


注意 : 扩展 名 . cs 是 C 井 代码 文件 专用 后 缓 . 即 C Sharp 的 缩写 。 


步骤 7: 此 时 会 看 到 如 代码 清单 2-1 所 示 的 程序 代码 。 
代码 清单 2-1 Program. cs 


using System; 


namespace MyApp 
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class Program 
于 
static void Main(string[ ] args) 
Console. WriteLine("Hello World! "); 


} 

步骤 8: 至 此 ,. NET Core 应 用 程序 项 目 在 Visual Studio 中 创建 完毕 。 

实例 15 在 Visual Studio 中 运行 项 目 

【导语 】 

在 上 一 个 实例 中 已 经 创建 了 一 个 控制 台 应 用 程序 项 目 , 本 实例 将 引导 读者 运行 应 用 
程序 。 
【操作 流程 】 
步骤 1: 对 Program. cs 文件 中 的 代码 进行 修改 ,把 “Hello World!? 改 为 “这 是 我 的 第 一 
个 应 用 程序 .”, 然 后 按 快 捷 键 Ctrl 十 S 保存 ,或 单 击 工具 栏 上 的 贺 按 钮 保存 。 修 改 后 的 代 
码 如 代码 清单 2-2 所 示 。 

代码 清单 2-2 ”修改 后 的 Program. cs 文件 


using System; 


namespace MyApp 
{ 
class Program 
{ 
static void Main( string[ ] args) 
{ 
Console. WriteLine(" 这 是 我 的 第 一 个 应 用 程序 。"); 
} 


} 


步骤 2: 从 菜单 栏 中 执行 “调试 ">“ 开 始 调试 ”, 或 者 按 F5 键 ,应 用 程序 就 会 以 调试 模 
式 运 行 。 
步骤 3: 此 时 控制 台 窗 口 一 启动 就 退出 了 。 那 是 因为 应 用 程序 已 经 执行 完了 ,如 果 想 看 
到 窗口 上 输出 的 文件 ,可 以 在 Main 方法 的 最 后 ( 右 大 括号 之 前 ) 加 上 一 行 Console. Read 方 
法 的 调用 ,这 样 应 用 程序 执行 到 这 里 会 停 下 来 ,以 等 待 用 户 的 输入 ,如 代码 清单 2-3 所 示 。 
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代码 清单 2-3 ”在 Main 方法 中 添加 的 代码 


static void Main(string[ ] args) 

{ 
Console. WriteLine(" 这 是 我 的 第 一 个 应 用 程序 ."); 
Console. Read( ); 


步骤 4: 再 次 运行 应 用 程序 ,就 能 看 到 如 图 2-13 所 示 的 输出 了 。 


的 车 一 个 应 用 粒 序 


2-13 ”应 用 执行 时 的 输出 
步骤 5: 在 系统 的 “任务 管理 器 ”窗口 可 以 查看 dotnet 进程 ,如 图 2-14 所 示 。 


文件 (F) 选项 (0) 查看 (V) 
进程 ”性 能 “应 用 历史 记录 启动 用 广 ” 详 别 信 息 服务 


名 称 命 4 行 站 
申 ChsIME.exe CAWindows\System32\InputMethod\CHS\ChsIME.exe -Embedding 

国 conhostexe \2DNCAWINDOWS\system32\conhost.exe Ox4 

国 conhostexe \2CAWINDOWS\systom32\conhost.exe Ox4 

国 conhost.exe \27\CAWINDOWS\system32\conhost.exe 0x4 

丽 conhostexe \enNCAWINDOWS\system32\conhost.exe Ox4 

国 csrssexe 

国 csrssexe 

区 cfmonexe “ctimon.exe” 

国 dasHostexe dashost.exe (e2f460eb-0aac-44bb-87ac8a695985e1a7} 

国 DataExchangeHost。 CAWindows\System32\DataExchangeHost.exe -Embedding 

Ml devenv.exe “CAProgram Files (x86)\Microsoft Visual Studio\2017\Enterprise\CommonT\IDE\devenv.exe” 

国 dlhostexe CAWINDOWS\system32\DIlHost.exe /Processid:(973D20D7-562D-44B9-870B-5AOF49CCDF3F) 

国 dllhostexe CAWINDOWS\system32\DIlHost.exe /Processid:(AB390284-09CA-4BB6-878D-ABF59079ABD5)} 

全 dostee -CNProgram Flesdotnsldotnetexe- xec.C\Users\aummu\source\repos\MySub\MyApp\bin\Debug\net:oreapp2.0\MyApp.dl 
国 dwmexe “dwrm.exe" 

Fr explorer exe CAWINDOWS\Explorer EXE 

国 fontdvhostexe “fontdrvhostexe” 

国 fontdrvhostexe “fontdrvhost.exe” 

国 IpoverUsbsvcexe "Ci\program Files (x86)\Common Files\Microsoft Shared\phone Tools\CoreCor\11.0\bin\IpOverUsbSvc.exe” 

lsassexe CNWINDOWS\system32\lsass.exe 

国 Microsoft Photos.e.. "CNProgram Files\WindowsApps\Microsoft Windows.Photos 2018.18022.158101000 x64_Bwekyb3d8bbwe\Microsoft.photos.exe... 
困 MsascuiLexe “Caprogram Files\Windows DefenderMSASCuiLexe” 

MSBuild.exe CAProgram Files (x86)\Microsoft Visual Studio\2017\Enterprise\MSBuild\15.0\Bin\MSBuild.exe /nologo /nodemode:1 /nodeReus.. v 
< | 
入 机 信息 (0) ES 


图 2-14 dotnet 命令 行 工具 出 现在 进程 列表 中 
并 且 ,dotnet 进程 中 附加 的 命令 行 参数 如 下 : 
"<. NET Core 运行 时 路 径 >\dotnet. exe" exec "< 应 用 程序 项 目 路 径 >\< 应 用 程序 名 称 >. dll" 
这 表明 Visual Studio 在 运行 应 用 程序 时 是 执行 了 dotnet 命令 的 ， 
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步骤 6: 如 果 在 执行 应 用 程序 时 不 希望 加 载 调试 信息 ,可 以 执行 “调试 ”~“* 开 始 执行 (不 
调试 )” 命 令 ,或 者 使 用 快捷 键 Ctrl 十 F5。 

实例 16 显示 代码 行 号 

【导语 】 

行 号 就 是 为 每 一 行 代码 进行 编号 。 在 代码 编辑 器 中 显示 代码 的 行 号 ,可 以 快速 定位 代 
码 的 位 置 。 

【操作 流程 】 

步骤 1: 执行 “工具 ”>“ 选 项 "命令 ,打开 “选项 ”对 话 框 。 


步骤 2: 在 左边 菜单 中 找到 “文本 编辑 器 ”菜单 项 ,然后 选择 一 种 编程 语言 ,如 图 2-15 
所 示 。 


上 源 代码 管理 二 
4 文本 篇 误 器 
3 局 用 虚 宇 格 (V) 
文件 扩展 名 加 启动 洲 行 (W) 
上 Basic 回 显示 可 视 的 自动 斤 行 标志 符号 (S) 
PC a 
b CoffeeScript | 
b Css 回 启用 单 击 URL 定位 (U) 
bp 回 导 航 芒 (N) 
HTML 回 自 动 补 全 大 括号 (B) 
b HTML(Web 瘟 体 ) 


b JavaScript/TypeScript 回 没 有 选 定 内 容 时 对 空 行 应 用 劳 切 或 复制 命令 (C) 


图 2-15 定位 文本 编辑 器 选项 


步骤 3: 在 对 话 框 右边 的 选项 卡 中 , 勾 选 “ 行 号 ” 复 选 框 ,然后 单 击 对 话 框 右 下 方 的 确定 
按钮 即 可 保存 。 

步骤 4: 如 果 需 要 所 有 编程 语言 的 代码 都 显示 行 号 ,可 以 在 “文本 编辑 器 ”命令 中 选择 
“所 有 语言 ”, 青 勾 选 “ 行 号 " 复 选 框 即 可 ,如 图 2-16 所 示 。 


b SQLServer Tools 

b TSQlg0 启用 让 空格 V) 

bP XAML 过 让 动 响 行 W) 

”XML 过 显示 可 视 的 自动 接 行 标志 符号 (5) 
bP 纯 文本 

上 所 有 语言 器 

请 试 [加 启用 单 击 URL 定位 (U) 


图 2-16 让 所 有 代码 显示 行 号 


步骤 $: 关闭 对 话 框 时 ,记得 单 击 “ 确 定 ” 按 钮 保存 设置 。 
步骤 6: 现在 代码 编辑 器 的 左 侧 就 会 显示 代码 行 号 了 ,如 图 2-17 所 示 。 


24 十 | .NET Core 实战 一 -手把手 教 你 掌握 380 个 精彩 案例 


t g TaskDesc 


imeSpan TaskDuration 


图 2-17 代码 行 号 


注意 : 无 论 是 编译 错误 ,还 是 调试 信息 ,Visual Studio 都 能 够 智能 地 定位 代码 位 置 ,因此 可 
以 隐藏 代码 行 号 。 但 显示 代码 行 号 对 于 开发 者 之 间 的 交流 是 有 好 处 的 ,例如 对 于 一 
份 由 团队 协作 编写 的 代码 ,在 讨论 代码 时 ,A 可 以 跟 己 说:“ 第 26 行 代 码 那 里 似乎 还 
辑 不 对 ,请 你 再 测试 一 下 。”,B 在 自己 的 机 器 上 打开 代码 文件 ,通过 行 号 可 以 快速 找 
到 第 26 行 代码 。 
对 于 有 一 定 规模 的 开发 团队 ,可 考虑 使 用 Visual Studio 的 团队 服务 来 进行 代码 审核 评定 。 


实例 17 在 C# Interactive 窗口 中 做 代码 实验 

【导语 】 

C# Interactive(C 井 交互 ) 是 Visual Studio 的 子 窗口 ,可 以 在 窗口 中 直接 编写 代码 ,无 
须 新 建 项 目 。 此 功能 非常 适用 于 编写 简单 的 程序 代码 , 即 可 用 于 做 代码 实验 。 例 如 需要 测 
试 一 个 Environment 类 的 MachineName 属性 会 返回 什么 内 容 , 这 种 情况 下 没有 必要 刻意 新 
建 一 个 项 目 做 测试 ,可 以 在 C# Interactive 窗口 中 直接 编写 代码 来 实验 。 

【操作 流程 】 

步骤 1; 在 开发 环境 窗口 的 菜单 栏 中 执行 “视图 ”- 盖 其 他 窗口 ”一 “C# 交 互 ? 命 令 ,打开 
C# Interactive 窗口 ,如 图 2-18 所 示 。 


图 2-18 C# Interactive 初始 化 
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步骤 2: 以 列举 所 有 受 支持 的 区 域 与 语言 信息 为 例 。 输 入 一 行 using 指令 ,然后 按 下 
Enter 键 确 定 , 引 入 需要 的 命名 空间 ,输入 代码 如 下 。 


> using System. Globalization; 


注意 : 代码 前 面 的 “ 盖 ? 是 交互 脚本 在 代码 的 行 首 自动 生成 的 字符 ,不 属于 代码 部 分 。 


步骤 3: 输入 以 下 代码 ,获取 并 输出 各 个 区 域 /语言 的 标识 、 显 示 名 称 及 LCID 值 。 


> using System. Globalization; 
> var cultures = CultureInfo.GetCultures(CultureTypes. AllCultures); 


> foreach(var c in cultures) { 
. Console. WriteLine( $ "{c. Name, — 20}{c. LCID, - 10}{c. DisplayName, — 30}"); 


“和 

在 上 面 代码 中 ,首先 调用 GetCultures 静态 方法 返回 一 个 CultureInfo 类 型 的 数组 , 然 
后 使 用 foreach 语句 访问 数组 中 的 每 个 CultureInfo 对 象 ,分 别 通过 Name、 DisplayName、 
LCID 三 个 属性 获取 所 需 信息 。 

步骤 4: 输入 完 代码 后 , 按 下 Enter 键 ,代码 脚本 会 进行 编译 并 且 执 行 ,最 后 会 在 C# 
Interactive 窗口 中 输出 如 图 2-19 所 示 的 内 容 。 


Yangben 


摩洛哥 ) 


4096 
zh-Hans-MO 4096 
zh-Hant 31748 
zh-HK 3076 
zh 5124 

4100 


2-19 ”输出 区 域 /语言 信息 
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注意 : 在 C# Interactive 窗口 中 ,输入 #clear 或 #cls, 可 以 清空 窗口 中 的 显示 内 容 , 输 入 
并 reset 可 以 重 置 脚本 , 即 重新 初始 化 。 
一 旦 按 下 Enter 键 提交 后 ,代码 就 无 法 修改 了 ,如 果 输 错 了 ,只 能 重新 输入 。 


实例 18 在 解决 方案 中 添加 和 移 除 项 目 


【导语 】 

一 个 解决 方案 可 以 包含 一 个 或 多 个 项 目 , 在 创建 项 目 时 会 默认 创建 一 个 解决 方案 ,并 且 
将 该 项 目 添加 到 解决 方案 中 。 在 Visual Studio 的 “解决 方案 资源 管理 器 ”窗口 中 ,用 户 可 以 
很 轻松 地 添加 或 移 除 应 用 程序 项 目 。 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 项 目 , 项 目 名 称 为 Demol, 解 决 方案 名 称 为 MySub, 如 图 2-20 
所 示 。 


步骤 2: 打开 “解决 方案 资源 管理 器 ”窗口 ,在 解决 方案 名 称 上 右 击 ,从 菜单 中 执行 “ 添 
加 ”一 “新 建 项 目 ...” 命 令 ,选择 . NET Core 模板 中 的 类 库 项 目 , 命 名 为 Demo2。 添 加 新 项 目 
后 ,“ 解 决 方案 资源 管理 器 ”窗口 中 的 结构 如 图 2-21 所 示 。 


b 最 近 辣 ” 排序 依据 : 默认 值 
4 已 安里 


ls 控制 台 应 用 (.NET Core) Visual C# 


Visual C# Ce 
Windows 经 左 点 面 Visual C# 
.NET Core 
.NET Standard 
Cloud 
Web 


[0 CorejVisual C# 


页 有 目 LNET Core) Visual C# 


应 用 程 .Visual C# 


加 解决 方案 MySub' (2 个 项 目 ) 


图 2-20 新 建 第 一 个 项 目 图 2-21 此 时 解决 方案 中 有 两 个 项 目 


步骤 3: 如果 需 要 移 除 Demo2 项 目 , 可 以 在 项 目 名 称 上 右 击 ,从 菜单 中 执行 “删除 ?命令 
即 可 。 


实例 19 添加 NuGet 包 引用 


【导语 】 
NuGet 包 是 专 为 . NET 开发 者 建立 的 开源 项 目 平台 , 它 已 成 为 Visual Studio 的 一 个 工 


第 2 应 用 程序 项 目 管理 | 27 


具 :, 能 够 简便 轻松 地 在 项 目 中 添加 各 种 组 件 。 

以 添加 PdfSharpCore 组 件 为 例 ,演示 如 何在 项 目 中 引用 NuGet 包 。 

【操作 流程 】 

步骤 1: 参考 实例 18 ,在 Visual Studio 中 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 打开 “解决 方案 资源 管理 器 ”窗口 ,在 “依赖 项 ? 结 点 上 右 击 ,从 菜单 中 选择 “管理 
NuGet 程序 包 ”, 如 图 2-22 所 示 。 


管理 NuGet 程序 包 (N)… 
限 范围 (S 


2-22 “管理 NuGet 程序 包 ” 莱 单 


步骤 3: 在 搜索 框 中 输入 “PdfSharpCore”, 选 中 查找 结果 中 的 PdfSharpCore 组 件 , 在 窗 
口 右 侧 窗 格 中 单 击 “ 安 装 ” 按 钮 (如 图 2-23 所 示 ),Visual Studio 会 自动 引用 组 件 。 


国 PdfSharpCore 
PdfsharpCore 和 Stcfan Stciger and Contributors, 224K 个 下 载 。 v101 sn 
pdfsharp for .NET Core 

版 本 ; 最 新 稳定 版 1.0.1 
HtmlRendererCore.PdfsharpCore 由 Nichc 
Dotnetcore Html to PDF 


图 2-23 安装 NuGet 包 


步骤 4: 此 时 ,在 “依赖 项 ”>NuGet 结 点 下 可 以 看 到 PdfSharpCore 组 件 , 如 图 2-24 所 示 。 


b 名 pdfsharpCore (1.0.1) 
b 六 spk 
bc program.cs 


图 2-24 ”PdfSharpCore 已 添加 到 项 目 中 
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若 要 删除 已 引用 的 NuGet 包 , 先 将 其 选中 ,然后 按 下 Del 键 或 从 快捷 菜单 中 执行 “ 移 
除 ” 命 令 。 


实例 20 清除 NuGet 包 缓存 


【导语 】 

下 载 NuGet 包 时 ,程序 包 会 存储 在 本 地 计算 机 ,因此 会 产生 缓存 文件 。 如 果 安 装 的 
NuGet 程序 包 比 较 多 ,缓存 占用 的 磁盘 空间 自然 会 增加 , 当 磁 盘 空 间 紧张 (或 有 些 程 序 包 不 
再 使 用 ) 的 情况 下 ,可 以 考虑 清理 缓存 。 

NuGet 程序 包 的 缓存 目录 一 般 位 于 C: \Users\< 用 户 名 >\. nuget\packages, 除 了 进入 
此 目录 手动 删除 程序 包 外 ,Visual Studio 本 身 也 提供 了 清理 缓存 的 功能 ,具体 操作 如 下 。 

【操作 流程 】 

步骤 1: 在 Visual Studio 开发 环境 中 ,从 菜单 栏 中 依次 执行 “工具 ”一 “选项 "命令 ,打开 
“选项 ”对 话 框 。 

步骤 2: 从 左边 的 导航 窗 格 中 选择 “NuGet 包 管理 器 ”, 右 边 的 内 容 页 中 会 看 到 一 个 “ 清 
除 所 有 NuGet 缓存 "按钮 , 单 击 它 就 可 以 清除 NuGet 程序 包 缓存 了 ,如 图 2-25 所 示 。 


搜索 选项 (Ctr|+E) 


程序 包 还 原 
上 源 代码 管理 pe 于 
上 文本 蛇 千 湛 回 多 许 NuGet 下 载 缺 少 的 程序 包 (A): 
上 调试 
性能 工具 回 在 Visual Studio 中 生成 期 间 自 动 检查 缺少 的 程序 包 (M) 
上 Arzure 服务 身份 验证 绑 定 重 定向 
上 》 昱 工具 
上 NuGet 包 管理 器 口 咒 过 应 用 和 绑 定 重 定 向 (B) 
上 SQL Server 工具 
b Web 程序 包 管理 
bP Web 窗 体 设计 器 
上 Web 性 能 测 式 T 具 默认 包 管理 格 式 : Packages.config ~ 
上 Windows 窗 体 设计 器 
Bs XAML 设计 器 口 允许 安装 篇 一 个 包 时 选择 格式 旧 
上 测试 
上 跨 平 台 ee 
数据 库 工具 清除 所 有 NuGet 短 存 人 
上》 文本 模板 化 


图 2-25 清除 NuGet 包 缓存 


实例 21 保存 窗口 布局 


【导语 】 

Visual Studio 支持 保存 子 窗口 的 布局 ,在 需要 的 时 候 可 以 迅速 套用 。 此 功能 适用 于 特 
定 偏好 的 开发 者 。 例 如 ,在 开发 Web 应 用 程序 项 目 时 可 以 使 用 自己 感觉 最 “顺手 ”的 窗口 布 
局 方案 ; 在 开发 其 他 类 型 的 应 用 程序 项 目 时 ,可 以 快速 切换 到 另 一 个 布局 。 

本 实例 将 演示 如 何 保存 窗口 布局 ,并 在 两 个 布局 方案 中 进行 切换 。 
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【操作 流程 】 

步骤 1: 启动 Visual Studio 开发 环境 。 

步骤 2: 通过 “视图 ”菜单 的 子 菜单 ,分 别 打 开 “ 解 决 方案 资源 管理 器 “类 视图 “输出 ”三 
个 窗口 。 

步骤 3: 把 “类 视图 ”窗口 放 在 左 侧 ,“ 解 决 方案 资源 管理 器 ”窗口 放 在 右 侧 ,并 把 “输出 ” 
窗口 放 在 主 窗口 的 底部 ,如 图 2-26 所 示 。 


名 | 


M 项目 四。 调 或 D) 所 从 (IM) 工具 0 测 t(S) 分 析 (N) 窗 Dom 。 弄 动 (H) 
[i 击 


Hx 


图 2-26 三 个 子 窗口 的 位 置 


步骤 4: 在 菜单 栏 中 执行 “窗口 >“ 保存 窗口 布局 ”命令 ,会 弹出 一 个 要 求 输入 布局 方案 
的 名 称 的 对 话 框 ,输入 “布局 方案 1”, 并 单 击 “ 确 定 ” 按 钮 ,如 图 2-27 所 示 。 

步骤 5: 依照 步骤 2 的 方法 ,通过 “视图 ”菜单 分 别 打开 “属性 "窗口 和 “工具 箱 ” 窗 口 。 并 
将 “属性 ”窗口 放 在 主 窗口 左 侧 ,“ 工 具 箱 ”窗口 放 在 主 窗口 右 侧 , 布 局 如 图 2-28 所 示 。 

步骤 6: 也 将 此 布局 保存 ,命名 为 “布局 方案 2”。 

步骤 7: 此 时 在 “窗口 ">" 应 用 窗口 布局 ”的 于 菜单 下 ,就 能 看 到 刚刚 保存 的 两 个 布局 方 
案 了 。 单 击 其 中 一 个 就 可 以 进行 布局 切换 。 

步骤 8: 执行 “窗口 >“ 管理 窗口 布局 ”命令 ,打开 “管理 窗口 布局 ”对 话 框 ,如 图 2-29 
所 示 。 

步骤 9: 在 该 对 话 框 中 ,用 户 可 以 对 布局 方案 重 命 名 、 重 新 排序 和 删除 。 
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BM) IAT MR) SW(N) 


布局 名 称 (L): 
布 用 方 实 1 


确定 (0) | | 取消 CO 


图 2-27 输入 布局 方案 名 称 


编 纺 日 、 杭 因 W 项 9) 沿 tD) BEAMW) 工具 四 人 析 (N) 窗口 
G PWi0.- | 外 


至 上 tw 本 可 拘 芋 活 加 5 县 


图 2-28 “属性 ”窗口 与 “工具 箱 "窗口 的 布局 
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重合 名 (BR) | | 删除 (D) 关闭 


图 2-29 “管理 窗口 布局 ”窗口 


实例 22 ”给 代码 打 书 签 


【导语 】 
在 某 行 代码 上 打上 书签 ,在 阅读 代码 时 可 以 快速 定位 ,其 用 途 与 现实 世界 中 的 书签 是 相同 的 。 
【操作 流程 】 


步骤 1: 打开 任意 代码 文档 。 
步骤 2: 在 代码 文档 中 找到 要 添加 书签 的 代码 行 ,并 在 该 行 中 任意 位 置 单 击 , 此 时 ,该 行 
周围 会 出 现 一 个 矩形 框 , 如 图 2-30 所 示 。 


args) 


BuildWebHost(args). Run () ;| 


2-30 ”确定 代码 行 


步骤 3: 执行 菜单 “编辑 ”书签 ”一 "切换 书签 命令。 书签 添加 成 功 后 ,会 在 代码 编辑 
器 左 侧 显示 辐 图 标 。 

步骤 4: 再 次 执行 “切换 书签 ”命令 ,可 以 取消 该 行 的 书签 。 

步骤 5: 当 书 签 数 量 较 多 时 ,还 可 以 执行 “视图 ”一 "其 他 窗口 ”一 "书签 窗口 ”命令 ,打开 
“书签 ”窗口 。 在 “书签 ”窗口 中 ,可 以 对 所 有 书签 进行 统一 管理 ,还 可 以 重 命名 书签 ,如 
图 2-31 所 示 。 


#E 
PEE 
Ne 


囊 关 入 口 点 
站 图 视图 组 件 页 面 


回国 注 制 器 
号 同 视图 组 件 


2-31 “书签 ”窗口 
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2.3 代码 注释 


实例 23 单行 注释 


【导语 】 

单行 注释 只 对 当前 行 有 效 ,而 且 只 能 写 一 行 注释 (自动 换行 除外 )。 注 释 以 “//” 开 头 ， 
“//” 之 后 的 内 容 皆 被 视 为 注释 。 

代码 注释 不 参加 编译 ,主要 用 途 是 说 明代 码 的 功能 或 调用 时 要 注意 的 事项 ,方便 人 们 阅 
读 和 理解 代码 。 在 编程 过 程 中 应 当 养 成 写 注释 的 好 习惯 , 既 方便 他 人 ,也 方便 自己 。 

【操作 流程 】 

下 面 注释 为 三 行 ,由 于 “//” 只 能 注释 一 行 ,所 以 每 一 行 开头 都 要 写 上 “//”。 

// 第 一 行 注 释 

// 序 列 化 一 个 对 象 

// 可 以 选用 XML 或 JSON 格式 

但 是 以 上 写法 并 不 完美 ,“//” 与 后 面 的 内 容 距 离 太 近 , 不 便于 阅读 。 可 以 考虑 在 “//" 之 
后 加 入 空格 ,例如 下 面 这 样 读 起 来 会 更 舒适 。 

// 第 一 行 注 释 

// 序列 化 一 个 对 象 

// 可 以 选用 XML 或 JSON 格式 


实例 24 ”多 行 注释 

【导语 】 

多 行 注释 可 以 将 一 行 或 多 行 标记 为 注释 ,格式 是 以 */* ”开始 ,以 “* /” 结 尾 。“/* ”与 
“* /” 在 代码 文档 中 必须 成 对 出 现 。 

【操作 流程 】 

以 下 注释 为 多 行 注释 ,在 注释 块 的 起 始 加 上 “/ * ”, 在 注释 块 的 结尾 加 上 “x /”， 


作者 :Mr Lu 
修订 日 期 :3 月 5 日 
修订 版 本 号 :v1.1 
开发 组 :A 组 


实例 25 文档 注释 
【导语 】 
文档 注释 是 针对 代码 文档 结构 而 设 定 的 , 它 可 以 将 类 型 或 类 型 成 员 的 详细 说 明文 本 提供 
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确 


给 调用 代码 的 开发 者 ,并 且 文 档 注释 也 会 显示 在 Visual Studio 代码 编辑 器 的 智能 提示 中 。 
文档 注释 通常 以 “///” 开 头 , 而 且 会 使 用 特定 的 XML 元 素 。 常 见 的 文档 注释 元 素 如 下 : 
(1) < summary >: 摘要 。 概 括 性 的 描述 ,一 般 用 于 类 型 和 类 型 成 员 ( 如 属性 .事件 、 方 
法 等 ) 。 
(2) < param >: 用 来 描述 方法 参数 ,需要 指定 name 值 ,使 注释 内 容 与 对 应 的 参数 关联 。 
(3) < returns >: 用 来 描述 方法 的 返回 值 。 
(4) < see>: 可 以 从 当前 注释 中 链接 到 其 他 类 型 。 
(5) < remarks>: 备注 信息 ,可 作为 < summary > 的 补充 。 
【操作 流程 】 
步骤 1: 声明 一 个 Person 类 ,其 中 包含 两 个 属性 。 


public abstract class Person 

{ 
public string Name { get; set; } 
public int Age { get; set; } 


} 
步骤 2: 分 别 为 Person 类 以 及 它 的 成 员 写 文档 注释 。 


/// < summary> 
/// 该 类 表示 某 个 人 的 基本 信息 
/// </sunnary> 
/// < remarks > 它 是 一 个 抽象 类 ,不 能 直接 实例 化 </remarks > 
public abstract class Person 
{ 
/// < sunmary> 
/// 姓名 
/// </summary> 
public string Name { get; set; } 


/// < sunmary> 
/// 年 龄 。 该 属性 的 值 为 < see cref = "Systen. Int32"/> 类 型 
/// </summary> 
public int Mge { get; set; } 
} 


步骤 3: 当 在 代码 中 使 用 Person 类 时 ,文档 注释 会 出 现在 智能 提示 中 ,如 图 2-32 所 示 。 


图 2-32 智能 提示 中 的 文档 注释 
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2.4 发布 .NET Core 应 用 项 目 


实例 26 在 Visual Studio 中 发 布 . NET Core 应 用 

【导语 】 

当 应 用 程序 的 开发 与 测试 工作 完成 后 ,将 其 发 布 之 后 就 可 以 在 其 他 机 器 上 运行 了 。 对 
于 ASP.NET Core 项 目 ,一 般 发 布 后 会 上 传 到 服务 器 中 运行 。 

本 实例 演示 将 如 何 通过 Visual Studio 开发 环境 提供 的 发 布 向 导 界 面 来 发 布 应 用 程序 


项 目 。 
【操作 流程 】 
步骤 1: 在 Visual Studio 中 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 打开 “解决 方案 资源 管理 器 "窗口 , 右 击 项 目 名 称 ， 
从 打开 的 菜单 中 选择 “发 布 ”命令 ,如 图 2-33 所 示 。 

步骤 3: 对 于 一 般 应 用 程序 , 仅 支 持 文件 目录 方式 发 布 ,也 
就 是 将 发 布 后 的 文件 复制 到 指定 的 目录 中 。 默 认 发 布 目录 位 于 
当前 项 目的 bin\ Release\PublishOutput 子 目 录 中 .如 果 需 要 更 改 
目录 ,可 以 单 击 “ 浏 览 ” 按 钮 ,然后 选择 一 个 目录 ,如 图 2-34 所 示 。 


选取 发 布 目标 


A 


文件 去 或 文件 共享 


图 2-33 执行“ 发布" 命令 


ublishOutput 


创建 配置 文件 (P) ~ 取消 (加 


图 2-34 选择 发 布 目录 
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步骤 4: 向 导 对 话 框 右 下 角 的 按钮 旁边 有 一 个 下 三 角 按钮 , 单 击 后 可 以 选择 发 布 行为 。 
可 选项 为 “创建 配置 文件 ”和 “立即 发 布 "。 选 择 “ 立 即 发 布 " 后 会 马上 启动 发 布 操作 ,对 应 用 
程序 代码 进行 编译 并 把 生成 的 文件 复制 到 发 布 目录 中 。 笔 者 建议 选用 “创建 配置 文件 ”, 这 
样 可 以 先 对 相关 参数 进行 设置 ,再 执行 发 布 行为 。 

步骤 5: 如 图 2-35 所 示 ,如果 需要 修改 配置 参数 ,可 以 单 击 “ 设 置 ” 链 接 , 如 图 2-36 所 
示 ,修改 完成 后 单 击 “ 确 定 ” 按 钮 保存 。 


发 布 


将 应 用 发 布 到 Azure 或 另 一 台 主 机 


DD Folderprofile 


bin\Release\PublishOutput 艺 


图 2-35 新 建 的 发 布 配置 
配置 文件 设置 
配置 文件 名 称 : FolderProfile 
Release 
netcoreapp2.0 


可 移植 


bin\Release\PublishOutput 


图 2-36 修改 发 布 配置 
步骤 6: 单 击 “发 布 ”按钮 ,发 布 操作 随即 启动 ,等 待 其 自动 完成 即 可 。 
注意 : 普通 应 用 只 可 以 采用 目录 方式 发 布 ,而 对 ASP. NET Core 应 用 程序 项 目 而 言 ,不 仅 


可 以 将 应 用 程序 发 布 到 指定 目录 ,还 可 以 将 项 目 发 布 到 远程 服务 器 上 ,例如 使 用 FTP 
上 传 ,或 直接 发 布 Web 应 用 到 Azure 云 上 。 
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实例 27 使 用 Visual Studio 发 布 可 独立 运行 的 项 目 


【导语 】 

默认 发 布 所 生成 的 应 用 程序 文件 ,必须 依赖 . NET Core 运行 库 才 能 正常 运行 。 而 通过 
动 定义 特定 的 目标 平台 ,能 够 生成 可 以 直接 运行 的 应 用 程序 , 即 前 面 提 到 的 “ 自 包 含 ”模式 。 

使 用 “ 自 包含 ”模式 发 布 的 程序 文件 可 以 直接 复制 到 目标 机 器 上 运行 ,无 须 事 先 安装 
.NET Core Runtime。 由 于 该 发 布 方式 会 把 依赖 的 . NET 类 库 复 制 到 发 布 目录 中 ,所 以 显 
而 易 见 的 缺点 就 是 文件 体积 大 ,会 出 现 许多 重复 文件 。 

【操作 流程 】 

步骤 1: 在 “解决 方案 资源 管理 器 "窗口 中 右 击 项 目 名 称 , 执行 “编辑 < 项 目 名 称 > 
. csproj ”命令 ,其 中 ,< 项 目 名称 >. csproj 是 项 目 文件 。 

步骤 2: 此 时 会 用 文本 编辑 器 打开 项 目 文件 ,项 目 文件 本 身 就 是 一 个 XML 文档 。 NET 
Core 应 用 程序 的 项 目 文件 比较 简洁 ,主体 内 容 如 下 。 


mm 


< Project Sdk = "Microsoft. NET. Sdk"> 


< PropertyGroup> 

< OutputType > Exe </OutputType > 

< TargetFramework > netcoreapp2. 0 </TargetFramework > 
</PropertyGroup> 


</Project > 


其 中 TargetFramework 元 素 指定 目标 框架 的 版 本 ,目前 版 本 号 为 2.0。 
步骤 3: 在 PropertyGroup 结 点 下 添加 Runtimeldentifiers 元 素 ,并 指定 目标 平台 。 


< PropertyGroup > 
< RuntimeIdentifiers> win— x64;linux — x64;osx- x64 </RuntimeIdentifiers> 
</PropertyGroup> 
上 面 配置 使 应 用 程序 分 别 支持 64 位 的 Windows、Linux 和 MacOS 操作 系统 。 多 个 平 
台 标 识 之 间 用 半角 分 号 隔 开 。 
注意 : Runtimeldentifiers 元 素 支 持 添加 多 个 目标 平台 ,也 可 以 使 用 Runtimeldentifier, 但 
Runtimeldentifier 元 素 只 能 添加 单个 目标 平台 。 例 如 ， 
< RuntimeIdentifier > win10-x64 </RuntimeIdentifier> 
步骤 4: 保存 并 关闭 文本 编辑 窗口 ,重新 打开 发 布 配置 文件 设置 对 话 框 ,此 时 “目标 运行 
时 ”的 下 拉 列 表 框 中 能 够 选择 目标 平台 ,如 图 2-37 所 示 。 
步骤 5: 选择 一 个 平台 (例如 win-x64) ,然后 就 可 以 发 布 特定 平台 的 应 用 程序 了 ,而 且 


配置 文件 设置 
配置 文件 名 称 : Folderprofile 


Release 


netcoreapp2.0 


Win-x64 
linux-x64 
osx-x64 
win-x64 
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图 2-37 可 以 选择 目标 平台 


此 发 布 方式 所 生成 的 文件 是 “ 自 包含 模式 的 。 


如 图 2-38 所 示 ,发 布 后 生成 的 文件 列表 有 三 部 分 : 第 一 部 分 是 . NET Core 类 库 文件 ; 


第 二 部 分 是 一 个 . exe 文件 ; 第 三 部 分 是 一 个 . dl 文件 。 应 用 程序 代码 编译 到 . dl 文件 中 ， 


而 . exe 文件 仅 作为 程序 启动 器 。 


图 mscordaccore.dll 

国 mscordaccore amd64 amd64 4.6.00001.0.d1 
图 mscordbidll 

国 mscorlib.dll 

图 mscorrcdebug.dll 

图 mscorrcdll 

剧 MyAppdepsjson 

图 MyApp.dll 

国 MyAppexe 

口 wyApppdb 

怖 MyApp.runtimeconfigjson 

图 netstandard.dll 

图 sosdll 

SOS.NETCore.dll 

图 sos amd64 amd64 4.6.00001.0.dIl 

转 SystemAppContext.dll 

图 System.Buffers.dll 

图 system.Collections.Concurrent.dll 

图 system.Collections.dIl 

图 System.Collections.Immutable.dIl 

图 system.Collections.NonGeneric.dIl 

图 System.Collections.Specialized.dll 

图 System.ComponentModel.Annotations.dIl 
图 System.ComponentModel.Composition.dIl 
图 System.ComponentModel.DataAnnotations.dll 
图 System.ComponentModel.dll 


图 System.ComponentModel.EventBasedAsync.dll 
图 System.ComponentModel.primitives.dll 

图 System.ComponentModelTypeConverierdll 
辐 System.Configuration.dIl 

图 System.Consoledll 

图 system.Core.dll 

图 System.Data.Common.dll 

图 System.Data.dl 

图 System.Diagnostics.Contracts.dll 

图 System.Diagnostics.Debug.dll 

图 system.Diagnostics.DiagnosticSource.dll 

图 System.Diagnostics.FileVersionlnfo.dll 

图 System.Diagnostics.Process.dIl 

图 System.Diagnostics.StackTrace.dll 

图 System.Diagnostics.TextWriterTraceListener.dIl 
图 System.Diagnostics.Tools.dll 

图 System.Diagnostics.TraceSource.dl 

图 System.Diagnostics.Tracing.dll 

图 System.dll 

图 System.Drawing.dll 

图 System.Drawing.Primitives.dll 

图 System.DynamicRuntime.dl 

图 System.Globalization.Calendars.dll 

图 System.Globalization.dll 

图 System.Globalization.Extensions.dIl 

图 System.IO.Compression.dll 


图 2-38 “ 自 包含 ”发布 后 输出 的 文件 
步骤 6: 在 “命令 提示 符 " 窗 口中 输入 . exe 文件 的 名 字 , 可 以 直接 运行 应 用 程序 ,如 


图 2-39 所 示 。 
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国 CNWindows\system32Vcmdexe 
< i 以 本 10. 


图 2-39 直接 运行 应 用 程序 


用 于 指定 各 个 平台 的 标识 符 可 以 从 runtime. json 文件 中 获取 ,该 文件 默认 存储 在 C: 和 
Program Files\dotnet\sdk\NuGetFallbackFolder\microsoft. netcore. platforms\< 版 本 号 > 
目录 下 。 以 下 摘录 该 文件 的 部 分 内 容 ( 参 见 代码 清单 2-4)。 


代码 清单 2-4 runtime. json 文件 (局 部 ) 


{ 
"runtimes": { 
"base": { 
i 
any™: { 
"#import": [ "base" ] 
}, 
"android": { 
"#import": [ "any" ] 
by 
"android— arm": { 
"#import": [ "any" ] 
}, 
"android— arm64": { 
ea import" "any” ] 
扳 
"win": { 
了 import" "any"” ] 
}， 
"win— x86": { 
"#import": [ "win" ] 
入 
"win— x64": { 
"#import": [ "win" ] 
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"win81" ] 
"win10", "win81— x86" ] 
"win10", "win81— x64" ] 
mad 
eR | 
}, 
"unix—x64": { 
mi" ni | 
洲 
ew 
"# import": [ "unix" ] 
}, 
"osx— x64": { 
"#import": [ "osx", "unix— x64" ] 
}, 
onx: 10. 10"s § 
"#import": [ "osx" ] 
}, 
"osx. 10.10— x64": { 
"#import": [ "osx.10.10", "osx— x64" ] 
}, 
“igs { 
"#import": [ "unix" ] 
}, 


"linux— x64": { 
"#import": [ "linux", "unix— x64" ] 


}, 


"centos": { 
"#import": [ "rhel" ] 
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} 
"centos— x64": { 

"#import": [ "centos", "rhel— x64" ] 
}, 


"opensuse. 42.1— corert": { 
"# import": [ "opensuse. 13.2— corert", "opensuse. 42.1" ] 
}, 
"opensuse. 42.1— x64— corert": { 
"# import": [ "opensuse. 42. 1 — corert", "opensuse. 13. 2 — x64 — corert", 
"opensuse. 42.1— x64" ] 
}, 


} 


其 中 ,#import 属性 表示 向 下 兼容 。 例 如 ,win-x64 可 以 兼容 win7-x64 和 win10-x64， 
ubuntu-x86 可 以 兼容 ubuntu. 15. 04-x86 。 


实例 28 ”使 用 dotnet 命令 行 工具 发 布 “ 自 包 含 ? 项 目 


【导语 】 

除了 可 通过 Visual Studio 开发 环境 来 发 布 “ 自 包含 ”项目 ( 即 可 以 独立 运行 的 项 目 ) 外 ， 
还 可 以 使 用 . NET Core 命令 行 工 具 一 一 dotnet 来 发 布 。 

在 使 用 dotnet 工具 发 布 项 目 之 前 ,可 以 使 用 实例 27 中 介绍 的 方法 编辑 项 目 文件 ,在 文 
件 中 加 入 < RuntimeIdentifiers > 或 < RuntimeIdentifier > 元 素 ,以 指定 要 发 布 的 目标 平台 , 当 
然 这 是 可 选 的 。 当 没有 在 项 目 文件 中 指定 目标 平台 时 ,编译 器 也 能 根据 传递 给 dotnet 命令 
的 -r 参数 来 输出 符合 目标 平台 的 可 执行 文件 (能 在 目标 平台 上 直接 运行 的 文件 ) 。 

【操作 流程 】 

步骤 1: 在 任意 目录 下 新 建 一 个 目录 ,命名 为 Demo。 


md Demo 

步骤 2: 进入 Demo 目录 。 

cd Demo 

步骤 3: 创建 一 个 新 的 控制 台 应 用 程序 项 目 。 


dotnet new console 


步骤 4: 本 例 将 发 布 可 以 在 Debian(Linux 系统 ) 上 独立 运行 的 应 用 程序 ,输入 以 下 


伟 
必 
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dotnet publish - c release —r debian— x64 


其 中 -c 参数 指定 要 生成 的 版 本 ,在 调试 阶段 ,可 以 指定 为 debug 版 本 ; 在 正式 发 布 时 ,应 当 
使 用 release 版 本 。 本 实例 直接 使 用 release 版 本 ,该 版 本 会 生成 极 少 (或 者 没有 ) 调 试 信息 ， 
可 提升 程序 执行 效率 。-r 参数 指定 目标 平台 ,例如 win7-x64、linux-x86、ubuntu-x64 等 ,本 
实例 使 用 debian-x64。 


注意 : -r 参数 只 能 指定 一 个 目标 平台 ,如 果 有 多 个 要 发 布 的 目标 平台 ,可 以 多 次 执行 dotnet 
publish 命令 ,并 且 指 定 不 同 的 -r 参数 。 


步骤 5: 执行 完 发 布 命令 后 ,在 “\bin\release\netcoreapp < 版 本 号 >\< 目 标 平台 >” 目 录 
下 会 生成 应 用 程序 文件 ,并 且 在 publish 子 目 录 下 会 包含 应 用 程序 文件 以 及 依赖 的 所 有 运 
行 时 库 。 

步骤 6: 在 Debian 系统 上 执行 发 布 的 应 用 程序 前 ,需要 安装 两 个 依赖 的 包 , 请 执行 以 下 
命令 进行 安装 : 

sudo apt install libunwind8 libicu57 


ICU 软件 包 支 持 对 UTF-8 等 Unicode 编码 的 处 理 。 
步骤 7: 把 publish 目录 下 的 所 有 文件 复制 到 Debian 系统 上 。 
步骤 8: 定位 到 Demo 文件 所 在 目录 。 


cd < 具体 路 径 > 
步骤 9: 输入 程序 文件 名 , 即 可 执行 。 
.VDeno 
注意 : 在 Linux 操作 系统 上 执行 程序 文件 ,需要 在 文件 前 面 加 上 “. /”。 


步骤 10: 如 果 输 出 “Helle World!”, 说 明 程 序 已 正常 运行 。 


C 间 语言 基础 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
， 使 用 命名 空间 ; 

， 变量 与 常量 ; 

。 声明 程序 入口 点 ; 

， 流程 控制 。 


3.1 命名 空间 


实例 29 ”使 用 namespace 关键 字 


【导语 】 

命名 室 间 有 两 个 作用 : 一 是 把 各 种 类 型 按照 用 途 进行 分 组 ,二 是 解决 命名 冲突 。 

第 一 个 作用 是 将 类 型 归 类 ,例如 在 . NET 类 库 中 , 有 一 个 System. Security. 
Cryptography 命名 空间 ,根据 其 命名 ,可 以 知道 在 该 命名 空间 下 面 的 类 型 与 安全 技术 有 关 ， 
并 且 包 含 用 于 加 密 或 解密 的 API。 

对 于 第 二 个 作用 ,假设 用 户 在 程序 代码 声明 两 个 类 型 ,它们 的 名 字 都 是 了 ,虽然 名 字 相 
同 , 但 两 个 P 类 型 的 功能 是 完全 不 同 的 。 为 了 解决 同名 冲突 ,就 可 以 分 别 把 两 个 P 类 型 放 
在 不 同 的 命名 空间 下 ,例如 第 一 个 P 类 型 放 在 N1 命名 空间 下 ,全 名 称 为 N1.P, 再 把 第 二 
个 P 类 型 放 在 N2 命名 空间 下 ,全 名 称 为 N2. P。 这 样 NI1. 了 与 N2.P 就 不 再 发 生命 名 冲 
突 了 。 

定义 命名 空间 使 用 namespace 关键 字 , 定 义 后 就 可 以 将 类 型 放置 在 命名 空间 中 。 

【操作 流程 】 

步骤 1: 在 Visual Studio 开发 环境 中 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 新 建 项 目 后 ,会 自动 打开 项 目 模板 生成 的 Program. cs 文件 。 从 生成 的 代码 中 
可 以 看 到 ,默认 的 命名 空间 与 项 目 名 字 相 同 ,例如 ,用 户 给 项 目 命名 为 Demo, 那 么 代码 默认 
的 命名 空间 同样 为 Demo。 如 代码 清单 3-1 所 示 。 
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代码 清单 3-1 ”模板 生成 的 命名 空间 


namespace Demo 


{ 


FE 


在 Demo 命名 空间 下 ,有 一 个 Program 类 (用 class 关键 字 声 明 ), Program 类 下 面 还 有 
-个 Main 方法 , 它 是 整个 程序 的 入 口 点 , 即 应 用 程序 会 从 Main 方法 开始 执行 , 当 退 出 
Main 方法 后 ,程序 也 随 之 退出 。 完 整 结构 如 代码 清单 3-2 所 示 。 


代码 清单 3-2 ”模板 生成 的 完整 程序 结构 


using System 


namespace Demo 
{ 
class Program 
{ 
static void Main( string[ ] args) 
{ 
Console. WriteLine( "Hello World! "); 
} 


} 


步骤 3: 在 项 目 生成 的 命名 空间 外 ( 即 命名 空间 的 右 大 括号 外 ) 另 起 新 行 , 使 用 
namespace 关键 字 声 明 一 个 Test 命名 空间 。 
namespace Test 


{ 
} 


注意 : 命名 空间 是 一 种 容器 ,里 面 可 以 包含 类 型 ,属于 代码 块 ,因此 在 命名 空间 后 面 要 加 上 
一 对 大 括号 。 


步骤 4: 在 定义 好 的 Test 命名 空间 两 个 大 括号 之 间 定 义 一 个 Car 类 。 声 明 类 使 用 
class 关键 字 ,class 也 是 一 种 类 型 。 

namespace Test 

E 


public class Car 
{ 


上 
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注意 : 类 型 内 部 可 以 包含 类 型 成 员 , 因 此 类 定义 之 后 也 要 附加 一 对 大 括号 。 


步骤 5: 在 Car 类 中 再 定义 一 个 方法 。 


namespace Test 
{ 
public class Car 
{ 
public void Run() 
， 
Console. WriteLine(" 开 车 啦 。"); 
} 


} 
当 调 用 Run 方法 时 ,会 在 控制 台 窗 口 输出 文本 信息 。 
步骤 6: 回 到 Program 类 的 Main 方法 ,用 以 下 代码 替换 默认 生成 的 代码 。 


static void Main(string[ ] args) 


{ 
Test. Car c = new Test.Car(); 


c. Run(); 
} 
上 面 代码 首先 声明 一 个 Car 类 型 的 变量 c, 并 且 通 过 new 关键 字 进 行 实例 化 ,然后 调用 
Run 方法。 


步骤 7: 按 F6 快捷 键 生成 解决 方案 。 

步骤 8: 打开 “命令 提示 符 ” 窗 口 ,定位 到 项 目 文件 目录 下 的 \bin\Debug\netcoreapp 
< 版 本 号 > 子 目 录 下 。 

步骤 9: 输入 以 下 命令 ,执行 应 用 程序 。 

dotnet < 项 目 名 称 >. dl1 


步骤 10: 如 果 看 到 和 输出 文本 * 开 车 啦 ”, 说 明 程序 已 经 正确 执行 。 
实例 30 符 套 命名 空间 


【导语 】 

命名 空间 下 面 不 仪 可 以 包含 类 型 ,还 可 以 殿 套 命名 空间 。 芭 命 名 空间 A 下 面 可 以 包含 
命名 空间 B, 命 名 空间 B 下 面 还 可 以 包含 命名 空间 C。 

【操作 流程 】 

步骤 1: 新建 控制 台 应 用 程序 ,命名 为 Demo。 

步骤 2: 在 生成 的 Demo 命名 空间 之 外 , 另 声明 一 个 命名 空间 ,命名 为 NTest。 
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namespace NTest 


{ 


} 
步骤 3: 在 NTest 命名 空间 下 再 声明 两 个 命名 空间 ,分 别 命名 为 NSubl .NSub2 。 


namespace NTest 
{ 
namespace NSubl 
L 


} 


namespace NSub2 
{ 


} 
} 


步骤 4: 在 NSubl 命名 空间 下 声明 一 个 类 ,命名 为 WorkTask。 


class WorkTask 


{ 


} 
步骤 5; 在 NSub2 命名 空间 下 ,声明 一 个 名 为 Tool 的 结构 。 


struct Tool 


{ 


} 
此 时 NTest 命名 空间 的 内 部 结构 如 代码 清单 3-3 所 示 。 
代码 清单 3-3 NTest 命名 空间 的 完整 代码 


namespace NTest 


{ 
namespace NSubl 


{ 


class WorkTask 


} 
} 


namespace NSub2 
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struct Tool 


{ 
} 


} 


步骤 6: 回 到 Program 类 的 Main 方法 ,在 方法 体 中 分 别 使 用 刚才 定义 的 两 个 类 型 来 声 
明 变量 。 
static void Main(string[ ] args) 
{ 
NTest. NSub1. WorkTask vi = null; 


NTest. NSub2. Tool v2; 
} 


引用 类 型 时 ,加 上 其 所 在 的 命名 空间 名 字 , 每 一 层 命名 空间 用 半角 名 点 分 隔 。 


注意 : 说 套 命 名 空间 主要 是 以 “. "运算 符 分 隔 。 在 实际 编写 代码 时 ,并 不 一 定 要 求 命 名 空间 
之 间 有 广 套 格式 ,例如 本 实例 中 的 代码 结构 也 可 以 写 为 : 
nanespace NTest. NSubl 
| 


class WorkTask 


{ 


} 
} 
nanespace NTest. NSub2 
{ 


struct Tool 


{ 
} 


实例 31 引入 命名 空间 

【导语 】 

使 用 using 指令 可 以 在 代码 中 引入 命名 空间 。 引 入 命名 空间 后 ,在 代码 中 访问 某 个 类 
型 时 就 不 必 敲 入 命名 空间 的 名 字 ,使 代码 更 简洁 ,可 读 性 更 高 。 

using 指令 可 以 在 以 下 两 处 使 用 : 

(1) 代码 文件 顶部 ,在 所 有 代码 之 前 。 此 处 所 引入 的 命名 空间 ,可 以 在 整个 代码 文件 中 
使 用 。 不 管 当前 代码 文件 中 有 多 少 个 命名 空间 ,有 多 少 个 类 型 , 均 可 使 用 。 
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(2) 在 某 个 命名 空间 内 。 此 处 只 在 当前 命名 空间 内 有 效 ,在 当前 命名 空间 以 外 不 可 用 。 

本 实例 将 以 System. Collections 命名 空间 下 的 类 型 进行 演示 。 

pao 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: ve Program. cs 文件 。 文 档 项 部 默认 已 经 引入 了 System 命名 空 
间 ,在 第 一 行 using 指令 后 面 ,引入 System. Collections 命名 空间 。 


using System; 
using System. Collections; 


步骤 3: 在 Main 方法 中 实例 化 一 个 ArrayList 对 象 ,并 向 其 中 添加 三 个 字符 串 实例 。 


ArrayList mylist = new ArrayList(); 

mylist. Add( "Tom" ); 

mylist. Add("Jim"); 

mylist. Add( "Jack" ) ; 

ArrayList 是 一 个 容量 可 自动 增长 的 数组 类 型 ,可 以 向 其 添加 任意 类 型 的 元 素 。 

如 果 没 有 使 用 using 指令 引入 System. Collections 命名 空间 ,那么 在 访问 ArrayList 类 
的 时 候 就 必须 写 上 完整 的 命名 空间 ,例如 : 

System. Collections. ArrayList mylist = new System.Collections. ArrayList(); 

这 样 代 码 会 变 得 元 长 ,而且 阅 读 起 来 也 不 方便 。 尤 其 是 在 一 个 代码 文件 中 多 处 使 用 同 

-个 命名 空间 时 ,通过 using 指令 在 文档 的 顶部 引入 后 ,不 必 在 代码 中 重复 输入 命名 空间 。 
步骤 4: 输出 ArrayList 对 象 中 所 有 元 素 。 


Tom 


foreach(object o in mylist) Jim 
{ Jack 


Console. WriteLine(o); 
} 3-1 输出 ArrayList 


i 实例 中 的 元 素 
步骤 5: 运行 应 用 程序 ,输出 结果 如 图 3-1 所 示 。 
实例 32 在 命名 空间 内 部 引入 其 他 命名 空间 


【导语 】 

using 指令 既 可 以 在 代码 文档 的 顶部 使 用 ,也 可 以 在 某 个 命名 空间 内 部 使 用 ,此 时 要 注 
意 所 引入 的 命名 空间 只 在 当前 命名 空间 中 有 效 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 ,并 命名 为 Demo。 

步骤 2: 在 生成 的 Program. cs 文件 中 ,会 创建 默认 的 Demo 命名 空间 。 请 读者 手动 把 
Demo 命名 空间 外 部 的 using 指令 代码 (模板 默认 生成 ) 删 除 。 

步骤 3: 在 Demo 命名 空间 内 部 加 入 以 下 using 指令 。 
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namespace Demo 


{ 
using Systenm; 
using Systen. Collections. Generic; 
} 
步骤 4: 实例 化 一 个 List < int > 对 象 ,并 添加 4 个 元 素 。 
List<int> list = new List< int> 
{ 
100,200,300 
}; 
如 果 不 引 入 System. Collections. Generic 命名 空间 ,那么 在 访问 List < 下 > 类 时 就 要 写 
上 完整 的 命名 空间 。 
System. Collections. Generic. List < int > list = new System. Collections. Generic.List < int> 
{ 


100,200, 300 
}; 


注意 : 由 于 System. Collections. Generic 命名 空间 是 在 Demo 命名 空间 中 引入 的 ,所 以 在 
Demo 命名 空间 以 外 的 代码 要 访问 List < 本 > 类 就 必须 使 用 System. Collections. 
Generic. List< 卫 >, 而 不 能 直接 使 用 List< 工 >。 


实例 33 ”使 用 全 局 命名 空间 

【导语 】 

应 用 程序 项 目 隐藏 着 一 个 根 命名 空间 , 即 全 局 命名 空间 。 全 局 命名 空间 可 以 包含 项 目 
中 的 所 有 类 型 的 访问 范围 ,包括 项 目 中 所 引用 的 其 他 组 件 。 

由 于 根 命名 空间 是 隐 式 存在 的 , 它 没有 明确 的 名 称 ,所 以 访问 它 就 必须 使 用 global 关 
键 字 。 该 关键 字 一 般 用 来 解决 类 型 与 命名 空间 的 命名 冲突 问题 ,在 以 下 实例 中 进行 演示 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Program 类 中 声明 一 个 嵌 套 的 类 ,命名 为 System。 


class Program 

{ 
public class System { } 
static void Main(string[ ] args) 
{ 


上 
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步骤 3: 在 Main 方法 中 尝试 实例 化 System. Version 类 。 
System. Version v = new System. Version( ) 


此 时 会 发 生 错 误 , 因 为 此 处 被 识别 为 上 面 定 义 的 System 类 ,而 且 System 类 中 没有 铸 
套 的 Version 类 , 即 编译 器 把 System. Version 识别 为 System 类 的 赃 套 类 Version 。 

步骤 4: 如 果 要 使 用 System 命名 空间 下 的 Version 类 ,就 必须 显 式 加 上 global 关键 字 ， 
通过 全 局 命名 空间 强制 指向 System 命名 空间 下 的 Version 类 。 


global: :System. Version v = new global: :Systen. Version(); 
此 时 ,编译 器 就 能 正确 识别 System. Version 类 。 
实例 34 为 引入 的 命名 空间 设置 别名 


ps 
尽管 命名 空间 在 类 型 声明 阶段 解决 了 命名 冲突 的 问题 ,然而 该 冲突 在 引入 命名 空间 后 
依然 会 出 现 。 例如 ,命名 空间 A 下 面 有 一 个 Product 类 ,完整 名 称 为 A. Product; 命名 空间 
B 下 而 也 有 一 个 Product 类 ,完整 名 称 为 B. Product。 如 果 将 A、B 两 个 命名 空间 同时 引入 ， 
那么 在 代码 中 直接 访问 Product 类 会 发 生 歧 义 , 即 编译 器 无 法 判断 使 用 了 哪个 命名 空间 下 
的 Product 类 。 

如 果 命 名 空间 的 名 称 比较 短 ( 如 上 面 举例 中 的 A、B), 则 访问 类 型 时 可 以 把 命名 空间 写 
全 , 即 在 代码 中 使 用 A. Product 或 B. Product; 但 是 如 果 命 名 空间 的 名 称 很 长 ,在 代码 中 访 
问 类 型 会 显得 元 长 。 例 如 把 上 面 举例 中 的 A 命名 空间 改 为 Company. Parts. WorkItems, 把 
B 命 名 空间 改 为 Company. Parts. CheckedItems, 那么 访问 Product 类 时 就 要 写 上 
Company. Parts. WorkItems. Product 或 Company. Parts. CheckedItems. Product。 很 明显 ， 
这 样 写 出 来 的 代码 并 不 简洁 。 

要 解决 这 个 问题 ,可 以 在 引入 命名 空间 时 分 配 一 个 别名 。 例 如 为 上 面 的 Company. 
Parts, WorkItems 分 配 一 个 别名 W ,这样 访问 Product 类 时 就 可 以 写 上 W. Product。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 

步骤 2: 在 Program. cs 交 件 市 定 旬 而 站 全 各 东阳。 


namespace Organization. Component. Extensions 


{ 
} 
namespace Organization. Component. MainParts 


{ 


50 二 .NET Core 实战 一 -手把手 教 你 学 握 380 个 精彩 案例 


步骤 3: 在 以 上 两 个 命名 空间 内 ,分 别 声明 一 个 BackgroundWork 类 。 


namespace Organization. Component. Extensions 


{ 
public class BackgroundNork { } 


} 


namespace Organization. Component. MainParts 
. 
public class BackgroundWork { } 


} 
步骤 4: 在 代码 文件 顶部 使 用 using 指令 引入 上 面 定义 的 两 个 命名 空间 ,并 为 它们 分 配 
-个 简短 的 别名 。 
using ext = Organization.Component. Extensions; 
using mps = Organization.Component.MainParts; 
步骤 5: 在 代码 中 访问 BackgroundWork 类 时 ,就 可 以 加 上 命名 空间 的 别名 。 虽 然 多 了 
个 前 绥 , 但 由 于 别名 比较 简短 ,代码 看 起 来 依然 很 简洁 。 


ext. BackgroundWork bwl 
mps. BackgroundWork bw2 


实例 35 使 用 using static 指令 


【导语 】 

使 用 using static 指令 ,可 以 像 引 入 命名 空间 那样 引入 某 个 类 型 (该 类 型 是 静态 类 或 者 
包含 静态 成 员 ) 。 引 和 类 型 后 ,在 代码 中 访问 其 静态 成 员 时 可 以 省 略 类 型 名 称 。 

本 例 以 System 命名 空间 下 比较 有 代表 性 的 两 个 类 来 做 演示 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 在 文件 的 顶部 ,使 用 using static 指令 引入 Console 和 Math 两 个 类 。 


new ext. BackgroundWork() ; 
new mps. BackgroundWork( ) ; 


using static System. Console; 
using static System. Math; 


步骤 3: 此 时 访问 Console. WriteLine 方法 可 以 不 写 Console 类 的 名 称 。 
WriteLine("Hello World!"); 
步骤 4: 同样 ,访问 Math 类 也 不 用 写 类 名 Math 。 


WriteLine( $ "5 的 平方 为 :{Pow(5d, 2d)}"); 
WriteLine( $ "一 650 的 绝对 值 是 : {Abs( -650)}"); 
WriteLine( $"16,33 中 最 小 的 数 是 :{Min(16, 33)}"); 


其 中 Abs、Pow 以 及 Min 都 是 Math 类 公开 的 静态 方法 ,如 果 不 使 用 using static 指令 ， 


则 上 面 三 行 代码 就 应 写成 
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Console. WriteLine( $ "5 的 平方 为 :{Math. Pow(5d, 2d)}"); 


Console. WriteLine( $" -650 的 绝对 值 是 : {Mat 


h.Rbs( — 650)}"); 


Console. WriteLine( $ "16,33 中 最 小 的 数 是 :{Math. Min(16,33)}"); 


显然 ,使 用 了 using static 指令 后 ,代码 可 以 更 简练 。 
3.2 变量 与 常量 
实例 36 ”一 次 性 声明 多 个 变量 
【导语 】 
变量 的 声明 语法 如 下 。 
< 类 型 > < 变量 名 > 


类 型 名 称 与 变量 名 称 之 间 要 有 空格 。 对 了 


F 同一 类 型 的 多 个 变量 ,可 以 逐个 声明 ,例如 


int x; 
int y; 
int 2; 


其 实 , 可 以 一 次 性 声明 多 个 类 型 相同 的 变 
ink VW 2 
【操作 流程 】 
步骤 1: 新 


1 建 控制 台 应 用 程序 项 目 。 


量 , 即 按照 以 下 格式 在 一 行 代码 中 同时 声明 。 


步 又 2: 十 时 3 0 cs 文件 。 


步骤 3: 在 Main 方法 中 声明 三 

string a; 

string b; 

string c; 

步骤 4: 可 以 在 一 行 代码 中 同时 声明 这 


string a, b, c; 
步骤 5: 也 可 以 在 声明 变量 时 进行 赋值 。 


stringd = null,e = "", f = "food"; 


三 个 变量 (变量 之 间 用 半角 去 


个 string 类 型 的 变量 。 


号 分 隔 ) 。 


实例 37 让 编译 器 自动 推断 变量 的 类 型 


【导语 】 


在 声明 变量 时 ,可 以 使 用 var 关键 字 来 描述 类 型 ,编译 器 会 根据 代码 给 变量 的 赋值 来 推 
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断 其 类 型 。 因 此 ,在 使 用 var 关键 字 声 明 变 量 后 要 马上 给 变量 赋值 ,否则 编译 器 无 法 推断 变 
量 的 类 型 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Main 方法 中 使 用 var 关键 字 声 明 一 个 变量 abc, 并 为 其 赋值 。 


var abc = 3.141d; 


数值 3. 141 带 有 后 级 d, 表 示 该 数值 为 double 类 型 ( 双 精 度 浮 点 数 ) ,因此 编译 器 推断 出 
变量 abc 的 类 型 为 System. Double。 

步骤 3: 可 以 使 用 以 下 代码 来 输出 变量 abc 的 类 型 。 

Console. WriteLine( $ "变量 abc 的 类 型 为 :{abc. GetType().FullName}"); 

GetType 方法 返回 一 个 Type 对 象 ,该 对 象 描述 与 类 型 有 关 的 详细 信息 。 应 用 程序 运 
行 之 后 ,将 输出 以 下 文本 。 


变量 abc 的 类 型 为 :System. Double 


注意 : 使 用 var 关键 字 声 明 的 变量 必须 初始 化 , 即 声明 后 必须 马上 赋值 。 因 为 编译 器 需要 
通过 分 配给 变量 的 值 来 推断 其 类 型 ,如 果 没 有 赋值 ,编译 器 就 不 知道 变量 是 什么 类 
型 了 。 


实例 38 使 用 常量 


【导语 】 

常量 与 变量 相对 ,变量 的 * 变 "意味 着 在 声明 并 初始 化 之 后 ,可 以 在 后 续 的 代码 中 修改 变 
量 的 值 ; 而 常量 的 “ 常 * 意 味 着 一 旦 初始 化 之 后 ,后 续 代码 无 法 修改 常量 的 值 。 

为 了 直观 地 看 出 变量 与 常量 的 区 别 , 本 实例 将 同时 使 用 变量 与 常量 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 变量 x 并 初始 化 ,然后 在 屏幕 上 输出 一 次 。 


int x = 10; 
Console. WriteLine( $ "修改 前 ,变量 x 的 值 :{x}"); 


步骤 3: 把 变量 x 的 值 改 为 100, 再 输出 一 次 。 


x = 100; 

Console. WriteLine( $ "修改 后 ,变量 x 的 值 : {x}"); 

变量 x 在 初始 化 时 设 定 为 10, 然 后 代码 把 它 的 值 修 改 为 100, 此 时 运行 代码 屏幕 上 会 输 
出 以 下 文本 。 


修改 前 ,变量 x 的 值 :10 
修改 后 ,变量 x 的 值 :100 


第 


步骤 4: 声明 常量 Z, 必 须 在 声明 后 立即 初始 化 。 


const int 2 = 500; 


声明 常量 的 方法 与 变量 类 似 ,只 是 要 加 上 const 关键 字 。 
步骤 5: 以 下 代码 试图 修改 常量 Z 的 值 。 


2 = 700; 


// 此 行 代码 会 报错 
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常量 的 值 一 旦 初始 化 ,是 不 能 被 修改 的 ,所 以 上 面 这 行 代码 会 发 生 编 译 错误 。 


注意 : 按照 习惯 ,常量 的 名 称 使 用 的 是 全 大 写 的 字母 。 但 这 只 是 习惯 ,并 不 是 语法 要 求 。 


实例 39 获取 变量 的 内 存 地 址 


【导语 】 


在 C++ 语言 中 ,通过 指针 变量 或 者 引用 运算 符 (&), 可 以 获得 变量 的 内 存 地 址 。 在 C# 


中 ,尽管 有 一 些 限制 ,仍然 可 以 进行 类 似 的 处 理 。 


指针 操作 在 C# 语言 中 被 认为 是 不 安全 的 ,因此 ,如 果 要 使 用 指针 变量 , 则 必须 将 相关 
的 代码 写 在 unsafe 代码 块 中 ,或 者 在 方法 的 声明 中 加 入 unsafe 修饰 符 。 
例如 ,以 下 代码 在 unsafe 代码 块 中 声明 指针 类 型 的 变量 。 


byte b = 255; 
unsafe 
{ 

byte* pb = &b; 
} 


以 上 代码 在 方法 声明 中 加 入 unsafe 修饰 符 , 表 示 该 方法 内 部 的 代码 中 会 出 现 不 安全 


代码 。 


unsafe void DoSomething( ) 
{ 
float £f = 0.0077f; 
float* pf = &f; 
} 


【操作 流程 】 


步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 


步骤 2: 打开 “解决 方案 资源 管理 器 "窗口 , 右 击 项 目 名 称 ,从 菜单 中 


步骤 3: 此 时 会 打开 项 目 


属性 窗口 ,然后 切换 到 “生成 "选项 卡 。 


步骤 4: 在 “常规 ”分 组 下 , 勾 选 “允许 不 安全 代码 ”, 如 图 3-2 所 示 。 


“属性 " 
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常规 


条 件 编译 符号 (W: 。 |NETCOREAPP2 0 
回 定义 DEBUG 常量 (U) 
回 定义 TRACE 军 量 四 


平台 目标 (G): Any CPU ~ 
口 首选 32 位 (P) 

回 允许 不 安全 代码 (日 

口 优化 代码 四 


图 3-2 人 允许 使 用 不 安全 代码 
步骤 5: 回 到 Program. cs 文件 ,在 Main 方法 上 加 上 unsafe 修饰 符 。 


static unsafe void Main(string[ ] args) 
{ 
} 


步骤 6: 声明 一 个 int 类 型 的 变量 并 初始 化 。 

int val = 200; 

步骤 7: 声明 一 个 指向 int 类 型 的 指针 ,并 且 引 用 变量 的 地 址 。 

int* p = Sval; 

步骤 8: 为 了 能 够 获取 并 输出 指针 变量 所 包含 的 地 址 ,还 需要 将 其 转换 为 IntPtr 类 型 。 


IntPtr ptr = (IntPtr)p; 
Console. WriteLine( $ "变量 的 地 址 :{ptr. ToString("x")}"); 


指针 类 型 并 非 从 Object 类 派生 ,所 以 它 没有 ToString 方法 。 要 想 在 代码 中 输出 指针 
指向 的 内 存 地 址 ,需要 将 其 转换 为 IntPtr 类 型 。 


实例 40 输出 变量 的 名 称 


【导语 】 

在 应 用 程序 中 输出 变量 的 名 称 ,实际 就 是 获得 变量 名 称 的 字符 串 表示 形式 ,这 需要 用 到 
nameof 运算 符 。 

【操作 流程 】 


步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 在 打开 的 Program. cs 文件 中 找到 Main 方法 ,在 方法 体内 部 声明 四 个 变量 ,并 
进行 初始 化 。 


string strvar = "hello"; 
int intvar = 3600; 
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var singlevar = 7.115f; 
var longvar = 6560000L; 
在 代码 中 使 用 不 带 任 何 后 级 的 数值 表示 整 型 数值 (32 位 整数 ) , 带 后 级 的 表示 单 精度 
浮 点 数值 , 带 工 后 级 的 数值 为 长 整 型 数值 (64 位 整数 )。 
步骤 3: 将 变量 的 名 称 与 实 值 输出 到 屏幕 。 
Console. WriteLine( $ "变量 {nameof (strvar)} 的 值 为 {strvar} 。"); 
Console. WriteLine( $ "变量 {nameof( intvar)} 的 值 为 {intvar} 。"); 


Console. WriteLine( $ "变量 {nameof(singlevar)】 的 值 为 {singlevar}。"); 
Console. WriteLine( $ "变量 {nameof (longvar)} 的 值 为 {longvar}。"); 


步骤 4: 按 F5 快捷 键 运行 应 用 程序 ,屏幕 输出 如 图 3-3 所 示 。 


图 3-3 输出 变量 的 名 称 


注意 : nameof 运算 符 不 仅 可 以 获取 变量 /常量 的 名 称 , 它 还 可 以 用 于 代码 文档 中 的 任何 对 
象 , 例 如 可 以 获取 命名 空间 名 、 类 型 名 类 型 成 员 名 等 。nameof 运算 符 能 返回 对 象 名 
称 的 字符 串 表 示 形 式 ,一 般 可 用 于 向 用 户 输出 变量 名 ,或 者 某 些 需要 以 字符 串 形 式 提 
供 对 象 名 称 的 情况 ,例如 通过 反射 技术 动态 查找 类 型 的 特定 成 员 。 


实例 41 为 变量 分 配 默认 值 


【导语 】 

在 声明 变量 时 可 以 为 其 分 配 一 个 初始 值 ,也 可 以 使 用 类 型 的 默认 值 。 例 如 ,int 类 型 的 
默认 值 为 0, 类 (class) 的 默认 值 是 null。 

要 获取 某 个 类 型 的 默认 值 ,建议 使 用 default 关键 字 ,该 关键 字 能 自动 返回 指定 类 型 的 
默认 值 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2; 声明 一 个 int 类 型 和 一 个 string 类 型 的 变量 ,分 别 用 default 关键 字 分 配 默 
认 值 。 

intv = default(int); 

tr dng = olittetri 


步骤 3: 在 屏幕 上 输出 两 个 变量 的 值 。 


Console.WriteLine( $ "int 类 型 的 默认 值 :{v}"); 
Console. WriteLine( $ "string 类 型 的 默认 值 :{s ?? "nu11"}"); 
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由 于 string 类 型 的 默认 值 是 null, 但 是 null 在 屏幕 中 无 法 输出 ,所 以 这 里 用 了 一 个 ?? 
运算 符 , 其 意思 是 : 如 果 字 符 串 变量 不 为 null, 就 输出 字符 串 内 容 ; 如 果 字 符 串 为 null ,就 输 


出 字符 串 “null”。 


步骤 4: default 关键 字 , 还 有 更 简洁 的 写法 ,就 是 不 必 指 定 类 型 。 例 如 上 面 声明 变量 的 


代码 可 以 改 为 


int v = default; 
string s = default; 


步骤 5: 此 时 需要 更 改 项 目 使 用 的 C# 请 言 版 本 ， 


资源 管理 器 "窗口 ,在 项 目 名 称 上 右 击 ,从 菜单 中 选择 % 


版 本 号 不 低 于 7.1。 打 开 “ 解 决 方案 
属性 ”, 打 开 项 目 属性 窗口 。 


步骤 6: 切换 到 “生成 ”选项 页 ,在 页 面 底部 找到 并 单 击 “ 高 级 ”按钮 。 
步骤 7: 语言 版 本 选择 7. 1 或 以 上 ,或 者 选择 “最 新 次 要 版 本 (最 新 )”, 然 后 单 击 “ 确 定 ” 


按钮 ,如 图 3-4 所 示 。 


语言 版 本 (D: C# 最 新 主要 版 本 (默认 ) 


A cf# 是 新 主要 版 本 你 认 ) 
内 部 编译 器 错误 报告 (): |C# 最 新 次 要 版 本 (最 新 ) 


口 检 运 算 上 灌 / 下 洪 (41SO-1 


1SO-2 
输出 一 一 一 cr3 
C#4 
调试 信息 (6): C#5 
C#6 
文件 对 齐 (j: C#70 
库 基 址 (B): 


J] 


图 3-4 选择 语言 版 本 


注意 : 由 于 default 关键 字 的 这 项 增强 功能 是 在 Ct 7 
的 语言 版 本 。 


3.3 程序 入 口 点 
实例 42 ”获取 命令 行 参数 


【导语 】 


.1 中 推出 的 ,因此 需要 修改 项 目 使 用 


程序 入 口 点 , 即 应 用 程序 开始 执行 的 位 置 , 进 入 入 口 点 后 ,代码 会 一 直 往 下 执行 ; 当代 
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码 退 出 入 口 点 后 ,应 用 程序 也 会 退出 ,整个 应 用 程序 生命 周期 结束 。 

程序 入 口 点 是 一 个 静态 方法 ,必须 命名 为 Main。Main 方法 中 一 般 会 有 一 个 字符 串 数 
组 类 型 的 参数 ,该 参数 用 于 接收 传递 给 应 用 程序 的 命令 行 参数 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 项 目 模板 默认 会 生成 Program 类 ,并 包含 一 个 Main 方法 ( 即 程序 人 口 点 )。 


static void Main(string[ ] args) 


} 
步骤 3: 输入 以 下 代码 ,在 屏幕 上 输出 命令 行 参数 。 


StringBuilder sbd = new StringBuilder(); 
sbd. AppendLine( "接收 到 的 命令 行 参数 :"); 
foreach (string a in args) 


{ 
sbd. AppendFormat(" {0}", a); 
} 


Console. WriteLine( sbd); 
应 用 程序 接收 到 的 命令 行 参数 会 传递 给 Main 方法 的 参数 args, 数 组 中 每 个 元 素 都 是 
-个 参数 。 
步骤 4: 要 在 调试 时 传递 命令 行 参数 ,需要 打开 “解决 方案 资源 管理 器 "窗口 ,然后 右 击 
项 目 名 称 ,从 菜单 中 执行 “属性 ”命令 ,打开 项 目 属性 窗口 。 
步骤 5: 在 项 目 属性 窗口 中 切换 到 “调试 "选项 卡 。 
步骤 6: 在 “应 用 程序 参数 ” 右 侧 的 文本 框 中 输入 三 个 测试 参数 。 


~ 


参数 之 问 用 空格 隔 开 ,如 图 3-5 所 示 。 


Beh: 下 


应 用 程序 梦 数 - 地 地 浊 


图 3-5 输入 用 于 测试 的 参数 


步骤 7: 按 F5 快捷 键 运 行 应 用 程序 ,在 控制 台 窗 口中 就 能 看 到 传递 的 命令 行 参 数 了 ， 
如 图 3-6 所 示 。 

步骤 8: 如 果 使 用 dotnet 命令 直接 执行 应 用 程序 ,可 以 把 需要 传递 的 参数 附加 在 . dll 文 
件 名 后 面 。 
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dotnet Demo.dll — hello 一 world 


其 中 Demo. dll 是 项 目 编译 后 生成 的 程序 文件 。-hello 和 -world 是 命令 行 参 数 。 
步骤 9: 执行 上 述 命令 后 ,会 输出 如 图 3-7 所 示 的 内 容 。 


图 3-6 输出 的 命令 行 参数 图 3-7 使 用 命令 行 执行 程序 


实例 43 ”处理 多 个 人 口 点 
【导语 】 

-个 应 用 程序 只 能 有 一 个 入 口 点 ,但 是 在 程序 代码 中 是 可 以 定义 多 个 Main 方法 的 。 

如 果 应 用 程序 项 目 中 包含 多 个 Main 方法 ,只 能 从 中 选择 一 个 作为 程序 的 入 口 点 。 

【操作 流程 】 
步骤 1: 新 建 控制 台 应 用 程序 项 目 。 
步骤 2: 项 目 模板 会 生成 一 个 Program 类 以 及 Main 方法 。 
步骤 3: 另 定义 一 个 Test 类 ,并 在 其 中 也 声明 一 个 Main 方法 。 


class Test 
{ 
static void Main( string[ ] args) 
{ 
Console. WriteLine(" 第 二 个 入 口 点 。"); 
Console. Read( ); 


注意 ; Main 方法 必须 是 静态 的 (static) ,但 不 要 求 是 公共 的 (public) 。 


步骤 4: 由 于 项 目 中 包含 了 两 个 Main 方法 ,此 时 运行 项 目 会 出 现 以 下 错误 。 
错误 、Cs0017 程序 定义 了 多 个 人 口 点 。 使 用 /main (指定 包含 入口 点 的 类 型 ) 进 行 编译 。 


步骤 5: 打开 项 目 属性 窗口 ,切换 到 * 应 用 程序 "选项 卡 ,在 “启动 对 象 "下 拉 列 表 框 中 选 
择 一 个 包含 Main 方法 的 类 ,如 图 3-8 所 示 。 此 时 应 用 程序 就 能 正常 运行 了 。 
启动 对 科 (O} 
Demo.Test ~ 


(未 设置 ) 
Demo.Program | 


图 3-8 选择 一 个 入 口 点 
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3.4 流程 控制 


实例 44 奇数 还 是 偶数 


【导语 
f 语句 能 够 对 代码 的 执行 进行 分 支 处 理 , 其 用 法 如 下 : 
证 (< 条 件 > ) 


{ 
代码 段 1 


代码 段 2 
} 
其 中 "< 条 件 >” 是 一 个 表达 式 , 其 结果 为 布尔 类 型 ( 真 或 假 )。 如 果 “< 条 件 >? 成 立 (为 真 ) ,就 
执行 “代码 段 1”, 和 否则 (为 假 ) 就 执行 “代码 段 2”。 
如 果 代 码 逻 辑 只 有 一 个 分 支 ,else 子 句 可 以 省 略 , 即 : 
证 ( < 条 件 > ) 
{ 
代码 段 1 
} 
当 “< 条 件 >” 成 立时 ,“ 代 码 段 1” 被 执行 ; 如 果 条 件 不 成 立 ,直接 
跳 过 “代码 段 1”。 
执行 本 实例 时 由 用 户 输入 一 个 数值 ,然后 程序 判断 该 数值 
是 奇数 还 是 偶数 ,最 后 将 结果 输出 到 屏幕 上 ,如 图 3-9 所 示 。 图 39 判断 数值 的 奇偶 性 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 调用 Console 类 的 ReadLine 方法 读 取 用 户 从 键盘 输入 的 内 容 。 


string input = Console.ReadLine(); 


其 中 ,ReadLine 方法 返回 一 个 字符 串 实例 , 它 表示 用 户 输入 的 文本 ,用 户 可 以 一 次 性 输入 多 
个 字符 ,并 按 Enter 键 确 认 。 

步骤 3: 得 到 用 户 输 入 的 内 容 后 ,还 需要 对 内 容 的 有 效 性 进行 验证 。 因 为 用 户 有 可 能 输 
入 了 非 数字 字符 (例如 输入 了 字母 ) ,而 且 本 实例 要 求 是 大 于 0 的 整数 ,例如 ， 


if(uint. TryParse( input, out uint number) && number > 0) 
{ 


} 
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else 

Console. WriteLine(" 你 输入 的 内 容 无 效 。"); 
其 中 ,TryParse 方法 能 够 对 字符 串 进 行 分 析 , 验 证 其 能 不 能 转换 为 uint 值 (无 符号 整数 ) ,如 
果 能 转换 ,就 把 转换 后 得 到 的 值 保存 到 变量 number 中 ,并且 TryParse 返回 true; 如 果 无 法 
转换 ,方法 会 返回 false。 

此 时 让 语句 的 判断 条 件 由 两 个 因素 组 成 。 首 先 ,输入 的 文本 必须 是 有 效 的 整数 ; 其 次 ， 
该 数值 必须 是 大 于 0 的 。 两 个 表达 式 用 运算 符 && 连接 ,表示 只 有 当 两 个 表达 式 同时 成 立 
时 ,站 请 句 的 判断 条 件 才 会 成 立 ; 如 果 其 中 有 一 个 不 成 立 ,那么 整个 判断 条 件 也 不 成 立 。 

步骤 4: 确保 用 户 输入 的 数值 有 效 后 ,就 可 以 分 析 其 奇偶 性 了 。 


if(uint. TryParse( input, out uint number) && number > 0) 


{ 


// 判断 整数 的 奇偶 性 
if( (number % 2) == 0) 
{ 
Console. WriteLine( $ "你 输入 的 {number} 是 偶数 。"); 
} 
else 
{ 
Console. WriteLine( $ "你 输入 的 {number} 是 奇数 。"); 
} 
} 
else 
{ 
Console. WriteLine(" 你 输入 的 内 容 无 效 。"); 
} 


奇偶 性 的 判断 依据 为 : 数值 是 否 能 被 2 整除 。 这 里 的 处 理 方法 是 让 number 变量 的 值 
除 以 2 并 取 其 余数 ,如 果 余 数 为 0 说 明 可 被 2 整除 , 即 为 偶数 ,否则 是 奇数 。 运 算 符 % 用 于 
获取 两 个 数 相 除 后 的 余数 。 


注意 : 本 实例 使 用 了 广 套 的 二 语句 , 即 在 这 语句 的 代码 块 中 又 包含 一 层 计 语句 ,在 一 些 复杂 
的 逻辑 处 理 中 是 允许 使 用 多 层 谋 套 的 这 语句 的 。 


实例 45 使 用 for 循环 输出 文本 
【导语 】 

for 循环 的 用 法 如 下 : 

for ( < 变量 初始 值 > ; < 循环 条 件 >; < 修改 变量 > ) 


代码 片段 
} 
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首先 通过 “< 变量 初始 值 >” 表 达 式 对 变量 (一 般 是 整数 值 的 类 型 ,如 int、long 等 ) 进 行 初始 化 
( 设 定 初 值 ) ,然后 启动 循环 ,“ 代 码 片 段 ” 处 的 代码 会 被 执行 。 执 行 完 “代码 片段 ”后 会 执行 
“< 修改 变量 >” 表 达 式 ,对 变量 的 值 进 行 修改 (通常 是 加 上 1) ,接着 使 用 “< 循环 条 件 >” 判 断 是 
否 再 需要 进行 循环 。 如 果 条 件 依然 成 立 , 则 “代码 片段 "处 的 代码 又 会 执行 ; 如 果 “< 循 环 条 
件 >” 不 成 立 , 就 会 跳出 for 循环 。 不断 地 循环 往返 ,直到 跳出 for 语句 块 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 运用 for 循环 ,在 屏幕 上 输出 5 行文 本 : 


for (intn = 1;n<= 5; n++) 
{ 
Console. WriteLine( $ "这 是 第 {n} 行文 本 。"); 

} 
其 中 变量 n 初始 化 为 1, 循环 的 条 件 是 n 要 小 于 或 等 于 5, 每 次 循环 
过 后 都 会 让 n 加 上 1。 例如 ,第 一 轮 循环 ,n 的 值 为 1, 输 出 “这 是 第 
1 行文 本 ”, 然 后 回 到 for 请 句 块 起 点 ,将 n 的 值 加 1, 变 为 2,2 小 于 
5, 因 此 条 件 成 立 , 继 续 循环 ,输出 “这 是 第 2 行文 本 ”"; 依 此 类 推 , 直 
到 nm 的 值 等 于 6 时 ,循环 条 件 不 再 成 立 , 就 会 退出 循环 。 运行 效 果 
如 图 3-10 所 示 。 


实例 46 ”生成 由 字符 组 成 的 图 案 


【导语 】 
本 实例 是 在 前 面 的 实例 基础 上 增强 的 。 首 先 , 通 过 循环 产生 以 下 图 案 : 


3-10 循环 输出 的 文本 


从 
从 

六 兴 关 

从 闪闪 关 

共 尖 闪闪 尖 

类 闪闪 关 关 关 
闪闪 尖 闫 关 关 关 
闪闪 关 关 关 关 关 关 


把 上 面 的 图 案 中 每 一 行进 行 反 转 , 即 


从 > 关 
六 兴 一 x 
共 兴 类 > 尖 关 关 
闪闪 关 关 > 类 关 关 关 
闪闪 关 关 关 久 闪 攻关 和 
类 闫 关 闫 闫 关 a 关 关 关 关 关 关 
闪闪 关 关 关 关 关 = 美洲 甘美 识 六 关 
闪闪 关 关 关 关 关 一 尖 关 关 关 关 关 关 关 
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接着 反 转 所 有 行 ,得 到 


闪闪 关 关 闪闪 关 关 关 关 关 关 关 关 半 尖 关 


闪闪 关 关 关 闫 关 。。 尖 关 关 关 关 关 关 
类 光头 关 关 关 六 关 关 类 关 关 
闪闪 关 关 关 关 关 关 关 
闪闪 关 关 闪闪 闪闪 
类 关 % 关 关 
x x 
* x 


最 后 把 所 有 行 再 做 一 次 反 转 ,并 拼接 到 上 面 各 行 后 面 , 就 能 得 到 如 下 最 终 图 案 。 


闪闪 关 关 美美 关 尖 尖 尖 关 关 关 关 关 关 


关 关 关 关 闪闪 关 。 关 关 关 关 闪闪 关 


闪 关 关 关 关 关 六 关 关 关 关 关 
闪闪 关 关 关 尖 关 关 关 关 
闪闪 关 关 关 关 关 关 
基准 类 基 关 兴 
攻关 闪闪 
* x 
* % 
从 闪闪 
闪闪 关 闪闪 兴 
类 闪光 关 关 关 关 关 
闪闪 关 关 关 关 关 闪闪 关 
闪闪 关 关 关 关 尖 关 关 关 关 关 


闪闪 关 关 闪闪 关 。 关 关 关 关 闪闪 关 


尖 关 并 关 并 关 关 关 关 关 关 关 关 关 关 关 


控制 台 最 终 输出 效果 如 图 3-11 所 示 。 
【操作 流程 】 po 
步骤 1: 新 建 控制 台 应 用 程序 项 目 。 Ss 
步骤 2: 通过 循环 ,产生 图 案 的 上 半 部 分 。 2 


List< string> listl = new List< string>(); 
for (intx = 1; x<= 8; xt+) 
i 

String sl = ""; 
intv = 0; 
while (v < x) 


{ 


Sl += "%"; 图 3-11 程序 最 后 输出 的 图 案 
TH 二 

} 

// 其 余 的 字符 用 空格 补 齐 , 使 字符 串 总 长 度 为 8 

sl = sl.PadRight(8); 
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// 将 整 行 字符 进行 反 转 , 并 产生 新 的 字符 串 

string s2 = new string( s1.Reverse( ) .Toarray() ) 
// 将 两 个 字符 串 进 行 拼接 

list1.Rhdd(s1 + s2); 


} 
步骤 3: 将 图 案 中 的 所 有 行 反 转 再 输出 。 
// 第 一 轮 输 出 


list1. Reverse(); 
foreach (var item in list1) 
{ 


Console. WriteLine( item) ; 


} 
步骤 4: 将 图 案 中 的 所 有 行 再 一 次 反 转 ,继续 输出 。 
// 第 二 轮 输出 


listl. Reverse( ); 
foreach (var item in list1) 
{ 


Console. WriteLine( item); 


} 
实例 47 死 循 环 的 处 理 方 法 
【导语 】 


所 请 死 循 环 ,就 是 永 不 休止 的 循环 。 循环 体内 部 的 代码 会 永久 性 地 执行 .产生 的 原因 在 
于 循环 条 件 永远 成 立 ,使 得 循环 体 无 法 退出 。 在 实际 编程 中 .要 避免 出 现 死 循 环 , 一 旦 遇 到 
死 循 环 .后续 的 代码 将 无 法 被 执行 。 

如 果 出 于 代码 逻辑 考虑 ,确实 要 设 定 永久 成 立 的 循环 条 件 (例如 ,3 所 5. 因 为 3 确实 小 于 
5, 这 样 的 条 件 永久 成 立 ) ,那么 也 要 在 适合 的 时 候 从 循环 体内 部 退出 循环 。 要 在 循环 体内 部 
退出 循环 ,可 以 使 用 break 语句 ,例如 : 


while (3<5) 


iE(…) 
{ 
break; 
} 
} 
【操作 流程 】 


步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 在 Main 方法 中 设置 一 个 死 循 环 。 
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while (9== 9) 

{ 

Console. WriteLine( $ " {DateTime. Now:T} 正在 执行 循环 … …"); 

} 

由 于 9 等 于 9 是 永远 成 立 的 ,所 以 上 面 的 while 循环 
代码 会 永远 地 执行 ,除非 强制 退出 应 用 程序 。 为 了 能 更 好 
地 看 到 Console. WriteLine 方法 被 无 限 次 调用 ,上 面 代码 
中 刻意 在 输出 的 文本 前 面 加 上 当前 时 间 。 

步骤 3: 按 F5 快捷 键 执行 程序 ,会 看 到 如 图 3-12 所 
示 的 输出 。 

步骤 4: 要 让 循环 终止 ,此 时 只 能 强制 关闭 应 用 程序 。 


实例 48 退出 循环 的 方法 


【导语 】 

前 面 提 到 过 ,使 用 break 语句 可 以 退出 循环 ,在 死 循 
环 内 部 更 需要 这 样 做 。 本 实例 将 实现 : 在 死 循环 执行 过 
程 中 ,只 要 用 户 按 下 下 键 ,就 可 以 退出 循环 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Main 方法 内 设 定 一 个 死 循 环 。 图 3-12 应 用 程序 在 执行 死 循 环 


while (true) 
{ 


} 


循环 条 件 始终 是 true, 表 明 这 个 条 件 是 永远 成 立 的 ,因此 这 是 一 个 死 循环 。 
步骤 3: 在 死 循环 内 部 ,加 退出 循环 的 条 件 。 


while (true) 
{ 
Console. WriteLine(" 请 按 EE 键 退出 。"); 
if(Console. ReadKey(true). Key == ConsoleKey.E) 
t 
break; 


} 
当 用 户 按 下 玉 键 后 ,使 用 break 语句 退出 循环 。 
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实例 49 输出 20 以 内 能 被 3 整除 的 正 整数 

【导语 】 

break 语句 会 直接 退出 整个 循环 ; 而 continue 语句 则 会 跳 过 本 轮 循环 ,重新 回 到 循环 代 
码 的 顶部 执行 下 一 轮 循 环 ,循环 并 不 会 退出 。 

本 实例 将 执行 一 个 从 1 到 20 的 循环 ,如 果 当 前 数值 能 被 3 整除 就 将 其 输出 ,否则 就 跳 
过 本 次 循环 。 例 如 ,当前 数值 为 5, 不 能 被 3 整除 , 则 直接 跳 过 ,不 再 往 下 执行 ,而 是 继续 下 

- 轮 循环 ; 然后 当前 数值 变 为 6, 可 以 被 3 整除 ,于 是 就 输出 数值 6 。 

【操作 流程 】 

步骤 1: 新建 控 制 台 应 用 程序 项 目 。 

步骤 2: 使 用 for 循环 对 1 到 20 的 正 整数 进行 试验 , 找 出 能 被 3 整除 的 数 。 

for(int i = 1; i<= 20; i++) 

: if ((i % 3) != 0) 

continue; 
Console. Write(" {0}", i); 

} 

当 数 值 不 能 被 3 整除 ( 即 除 以 3 后 余数 不 为 0) 时 ,执行 continue 语句 跳 过 本 次 循环 ; 如 
果 可 以 被 3 整除 ,就 输出 该 数值 。 

步骤 3: 按 F5 快捷 键 运行 程序 ,输出 结果 如 图 3-13 所 示 。 


图 3-13 20 以 内 可 被 3 整除 的 正 整数 


实例 50 ”做 一 道 选择 题 

【导语 】 

switch 语句 首先 提取 指定 表达 式 的 值 ,然后 将 该 值 与 各 个 case 开关 所 表示 的 分 支 进行 
匹配 ,如 果 与 其 中 一 个 分 支 的 值 相等 ,那么 就 执行 该 case 开关 下 的 代码 。 

switch 语法 如 下 : 

switch ( < 匹配 表达 式 > ) 

{ 


case nl: 
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break; 
case n2: 


break; 
default: 
break; 
} 
每 个 分 支 后 都 要 加 上 break、goto、return 等 语句 ,是 为 了 避免 代码 把 后 面 的 分 支 都 执 
行 ,如 果 某 个 分 支 匹配 后 就 继续 执行 后 面 的 分 支 ,就 损坏 分 支 语句 的 逻辑 结构 了 。default 
分 支 是 可 选 的 ,如 果 上 面 各 个 case 都 不 匹配 , 则 执行 default 分 支 的 代码 。 
本 实例 将 模拟 一 道 选择 题 , 用 户 通 过 输入 选择 进行 作答 ,代码 会 对 用 户 选 择 进行 分 析 ， 
并 给 出 被 选项 的 说 明 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 设 定 一 道 有 4 个 选项 的 选择 题 。 
Console. WriteLine(" 请 问 , 以 下 哪 位 历史 人 物 生活 在 唐 朝 ?"); 
Console. WriteLine("1、 蔡 沈 "); 
Console. WriteLine("2、 唐 寅 "); 


Console. WriteLine("3、 王 勃 ") 
Console.WriteLine("4、 苏 轼 "); 


步骤 3: 读 取 用 户 输入 。 


string input = Console.ReadLine(); 
ReadLine 方法 读 取 整 行文 本 并 返回 , 按 下 Enter 键 进行 确认 。 
步骤 4: 对 用 户 输入 的 选项 字符 串 进行 分 析 。 


switch (input) 
{ 
case "1": 
Console. WriteLine(" 蔡 党 生活 在 东汉 时 期 。"); 
break; 
case "2": 
Console. WriteLine(" 唐 寅 是 明 朝 人 。"); 
break; 
CASS 3 
Console. WriteLine(" 恭 喜 你 ,答对 了 。") 
break; 
case "4": 
Console. WriteLine(" 苏 轼 生活 在 北宋 时 期 。"); 
break; 


果 用 户 选 择 “1”, 并 非 正 确 答案 ,因而 告诉 用 户 “ 蔡 党 生 
活 在 东汉 时 期 ”。 
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default: 
Console. WriteLine(" 你 未 做 出 有 效 选择 ,"); 
break; 


} 
如 果 用 户 选择 "3”, 就 会 输出 恭喜 你 ,答对 了 ”;， 如 


步骤 5: 按 下 F5 快捷 键 ,运行 应 用 程序 ,输入 一 个 


选项 ,然后 按 Enter 键 确认 ,如 图 3-14 所 示 。 图 3-14 选择 一 个 答案 


实例 S1 switeh 语句 的 类 型 匹配 
【导语 】 
switch 语句 中 的 case 开关 除了 可 以 匹配 常量 外 ,还 可 以 匹配 类 型 。 当 测试 表达 式 的 类 


型 能 够 与 某 个 case 子 语句 所 指定 的 类 型 相 匹 配 时 ,就 会 执行 该 case 分 支 的 代码 。 代 码 清单 
3-4 演示 了 类 型 匹配 的 简单 用 法 。 


代码 清单 3-4 switch 语句 类 型 匹配 示例 


object vx = "abcde"; 
switch (vx) 
{ 
case int n: 
// 这 是 一 个 整数 值 
break; 
case string t: 
// 这 是 字符 串 
break; 
default: 
// 未 知 类 型 
break; 
} 


变量 声明 为 object 类 型 ,而 实际 赋值 时 使 用 了 string 类 型 的 值 。 第 一 个 case 于 语句 需 


要 int 类 型 的 值 ,类 型 不 匹配 ,因此 此 分 支 不 会 执行 ; 第 二 个 case 于 语句 需要 的 是 string 类 
型 的 值 ,类 型 匹配 ,所 以 该 分 支 会 被 执行 。 


在 使 用 类 型 匹配 时 ,一定 要 注意 类 型 的 兼容 性 问题 ,例如 以 下 有 A、B、C 三 个 类 ,其 中 ， 


B 类 从 A 类 派生 ,C 类 从 B 类 派生 。 


classA{} 
classB:A{} 
classC:B{} 


然后 在 switch 语句 中 使 用 类 型 匹配 。 
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object o = new B(); 
switch (o) 
1 
Case A x: 
// A\B\C 类 型 的 实例 均 匹 配 
break; 
Case Bx: 
// 只 有 B、C 类 型 的 实例 匹配 
break; 
Case Cx: 
// 只 有 C 类 型 的 实例 匹配 
break; 
} 


这 段 代 码 无 法 通过 编译 ,而且 在 Visual Studio 的 代码 编辑 器 中 也 会 提示 错误 ,错误 的 
原因 是 第 二 个 与 第 三 个 case 分 支 是 永远 不 会 被 执行 的 。 第 一 个 case 子 语句 匹配 类 型 为 A， 
即 无 论 测 试 表 达 式 中 的 实例 是 A 类 型 ,B 类 型 还 是 C 类 型 .都 能 够 与 该 case 分 支 匹 配 ,这 是 
因为 A、B、C 三 种 类 型 的 实例 都 能 赋值 给 A 类 型 的 变量 。 

要 解决 该 错误 ,最 简单 的 方法 就 是 调换 各 case 子 句 的 顺序 , 即 把 代码 改 为 : 

Switch (o) 

{ 


Case Cx: 
// A、B\C 类 型 的 实例 均 匹配 
break; 

Case B x: 
// 只 有 B\C 类 型 的 实例 匹配 
break; 

Case Ax: 


// 只 有 C 类 型 的 实例 匹配 
break; 
} 


修改 后 ,如 果 测 试 表 达 式 是 C 类 型 的 实例 ,那么 它 只 能 匹配 第 一 个 case 分 支 ; 同 理 , 如 果实 
例 是 B 类 型 , 它 无 法 赋值 给 C 类 型 的 变量 ,所 以 只 能 匹配 第 二 个 case 分 支 ; 如 果实 例 是 A 
类 型 , 它 无 法 赋值 给 B 和 C 的 变量 ,只 能 匹配 第 三 个 case 分 支 了 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 object 类 型 的 变量 ,并 赋 一 个 double 类 型 的 数值 。 


object obj = 0.0001d; 
步骤 3: 使 用 switch 语句 进行 类 型 匹配 。 


switch (obj) 


第 3 章 ”C# 语 言 基础 | 其 69 


case int v: 
Console. WriteLine( $ "{v} 是 一 个 int 值 。"); 
break; 

case decimal v: 
Console. WriteLine( $ "{v} 是 一 个 decinal 值 ."); 
break; 

case double v: 
Console. WriteLine( $"{v} 是 一 个 double 值 ."); 


break; 
default: 
Console. WriteLine(" 未 知 类 型 。"); 
国 Cc\Progra.. 
break; 0. 0001 是 一 


} 

上 述 代码 中 ,只 有 第 三 个 case 子 语句 能 够 匹配 ,因为 
obj 变量 的 实际 值 为 double 类 型 。 屏 幕 输 出 如 图 3-15 图 3-15 匹配 double 类 型 表达 式 
所 示 。 


实例 52 在 case 语句 中 使 用 when 于 句 


【导语 】 

case 语句 后 除了 使 用 常量 值 外 ,还 可 以 进行 类 型 匹配 。 为 了 让 类 型 匹配 更 加 精确 ,可 以 
在 case 语句 后 加 上 when 子 语句 。when 子 语句 所 使 用 的 表达 式 必须 返回 布尔 值 ,只 有 当 
when 子 语句 返回 true 时 ,该 case 语句 才 会 被 执行 。 

所 以 ,when 子 语句 就 相当 于 给 case 分 支 增 加 一 个 额外 的 条 件 , 以 进行 更 细致 的 筛选 。 
例如 ,通过 类 型 匹配 可 以 匹配 出 一 个 数组 对 象 实例 ,可 是 这 个 数组 有 可 能 是 空 数组 (元 素 个 
数 为 0) ,在 case 分 支 处 理 时 ,开发 者 可 能 会 考虑 当 出 现 空 数组 时 做 另外 处 理 , 此 时 ,when 子 
语句 就 发 挥 作用 了 。 以 下 代码 在 switch 语句 块 中 设 定 两 个 case 分 支 ,这 两 个 分 支 都 接受 数 
组 类 型 的 对 象 , 只 是 其 中 一 个 明确 接受 空 数组 。 


case Rrray arr when arr. Length == 0: 


break; 
Case Array arr: 
break; 
下 面 的 实例 将 会 进一步 演示 when 子 句 的 用 法 。 
【操作 流程 】 
步骤 1: 新建 控制 台 应 用 程序 项 目 。 
步骤 2: 在 生成 的 Program 类 中 增加 一 个 静态 方法 。 该 方法 接收 一 个 object 类 型 的 参 
数 , 并 使 用 switch 语句 块 进行 分 支 处 理 , 详 见 代 码 清 单 3-5。 
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代码 清单 3-5 ”DisplayInfo 方法 


static void DisplayInfo(object instance) 
{ 
Switch (instance) 


{ 

case null: 
Console. WriteLine(" 对 象 示 实例 化 ,"); 
break; 

case Array arr when arr. Length == 0: 
Console. WriteLine(" 这 是 个 空 数组 ,"); 
break; 

Case Array arr: 
Console. WriteLine( $ "数组 包含 {arr. Length} 个 元 素 。"); 
break; 

case IList ls when 1s.Count == 0: 
Console. WriteLine(" 这 是 个 空 列表 ,"); 
break; 

case IList 1s: 
Console. WriteLine( $ "列表 总 共有 {1s. Count} 项 。"); 
break; 


} 


null 值 不 会 匹配 任何 类 型 ,所 以 要 作为 一 个 常量 值 来 筷 选 。 在 使 用 when 子 语句 时 一 
定 要 把 握 好 case 的 顺序 。 例 如 上 面 代 码 中 对 空 数 组 的 分 析 , 假 设 把 两 个 case 语句 做 以 下 
调换 。 


case Array arr: 
Console. WriteLine( $ "数组 包含 {arr. Length} 个 元 素 。"); 


break; 

case Array arr when arr.Length == 0: 
Console. WriteLine(" 这 是 个 空 数组 。"); 
break; 


这 样 会 发 生 编 译 错误 。 因 为 不 论 数组 中 是 否 包含 元 素 ,第 一 个 case 语句 都 能 匹配 ,这 样 
会 使 得 第 二 个 case 语句 永远 无 法 匹配 ,等 同 于 第 二 个 case 语句 后 的 代码 永远 不 会 被 执行 。 
步骤 3: 分别 向 DisplayInfo 方法 传递 不 同 的 对 象 进行 测试 。 


// 测试 一 : 空 引用 
DisplayInfo(nul1) 
// 测试 二 : 空 数组 


int[] intarr = { }; 
DisplayInfo(intarr); 
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// 测试 三 : 空 列表 
List< long> listet = new List< long>(); 
DisplayInfo(listet); 


// 测试 四 :包含 元 素 的 数组 
lwtef ] btarr = { 36, 2, 54, 7 }; 
DisplayInfo(btarr); 


// 测试 五 :包含 列表 项 的 列表 
List< int> listint = new List< int> {21, 13, 62, 8, 19 }; 
DisplayInfo(listint); 


步骤 4: 按 下 F5 快捷 键 运行 项 目 , 会 看 到 如 图 3-16 所 示 图 3-16 when 子 句 演示 结果 
的 输出 。 
实例 53 ”代码 跳 转 


【导语 】 
在 代码 文档 中 ,可 以 在 某 段 代码 前 写 上 标签 ,然后 在 代码 的 其 他 位 置 使 用 goto 关键 字 
跳 转 到 指定 的 标签 处 ,并 继续 执行 标签 后 的 代码 。 


注意 : 此 处 所 说 的 标签 是 在 代码 逻辑 上 定义 的 标签 ,而 非 在 Visual Studio 中 为 代码 设置 的 
标签 。 


【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Main 方法 中 定义 五 处 标签 , 详 见 代码 清单 3-6。 
代码 清单 3-6 ”在 Main 方法 中 定义 五 处 标签 


left: 
Console. WriteLine(" 你 按 下 了 左 方向 键 。 
Console. Read( ); 

return; 


right: 
Console. WriteLine(" 你 按 下 了 右 方 向 键 ."); 
Console. Read( ); 


return; 


up: 
Console. WriteLine(" 你 按 下 了 向 上 键 。"); 
Console. Read( ); 
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return; 


down: 
Console. WriteLine(" 你 按 下 了 向 下 键 。"); 
Console. Read( ); 


return; 


other: 

Console. WriteLine(" 你 按 下 了 其 他 键 。"); 
Console. Read( ); 

return; 


标签 的 定义 方法 是 在 标签 名 称 后 面 紧 跟 一 个 英文 的 冒号 。 上 面 代 码 在 每 个 标签 后 的 代 
码 中 都 加 上 了 Console. Read 方法 的 调用 以 及 return 请 句 , 这 是 为 了 防止 代码 继续 往 下 执 
行 。 例 如 ,假设 代码 跳 转 到 left 标签 处 ,那么 left 标签 后 面 的 所 有 代码 都 会 被 执行 ,包括 下 
面 right、up 等 标签 后 面 的 代码 也 会 执行 。 因 为 代码 跳 转 到 某 个 标签 后 ,就 会 从 该 标签 处 继 
续 往 下 执行 ,直到 程序 退出 或 者 没有 可 执行 的 代码 。 

步骤 3: 调用 ReadKey 方法 从 键盘 输入 中 读 取 一 个 键 码 ,并 判断 哪个 键 被 激活 了 。 如 
果 按 下 了 Left 键 ,就 执行 left 标签 后 的 代码 ; 如 果 按 下 了 Right 键 ,就 执行 right 标签 后 的 
代码 ; 如 果 按 下 了 Up 键 ,就 执行 up 标签 后 的 代码 ; 如 果 按 下 了 Down 键 就 执行 down 标 
签 后 的 代码 ; 如 果 按 下 了 其 他 键 ,就 执行 other 标签 后 的 代码 。 


Var keyinfo = Console. ReadKey(true); 


证 (keyinfo.Key == ConsoleKey. LeftArrow) 
goto left; 

else if (keyinfo. Key == ConsoleKey. RightArrow) 
goto right; 

else if (keyinfo. Key == ConsoleKey. UpArrow) 
goto up; 

else if (keyinfo. Key == ConsoleKey. DownRrrow) 
goto down; 

else 


Aprog 一 器 尺 


goto other; 
在 goto 关键 字 后 面 直接 写 上 要 跳 转 的 代码 标签 即 可 。 
步骤 4: 运行 项 目 后 ,在 键盘 上 按 下 一 个 键 来 测试 ,结果 如 图 3-17 goto 语 名 测 试 
图 3-17 所 示 。 


面向 对 象 编程 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。 类 与 结构 ; 

委托 与 事件 ; 

。 继承 与 多 态 ; 

。 枚 举 ; 

， 特性 ; 

。 运算 符 ; 

类 型 转换 ; 

可 以 为 null 的 值 类 型 。 


4.1 类 与 结构 


实例 54 ”声明 公共 类 

【导语 】 

类 型 分 为 两 种 : 一 种 是 引用 类 型 ,存储 在 托管 堆 上 ,并 且 变 量 之 间 赋 值 只 复制 实例 引 
用 ,而 不 会 产生 新 实例 ; 另 一 种 是 值 类 型 ,存储 在 栈 内 存 中 ,变量 之 间 赋 值 会 产生 新 实例 。 

类 (class) 属 于 引用 类 型 。 默 认 情 况 下 ,使 用 class 关键 字 声 明 的 类 ,其 可 访问 性 为 
internal, 即 只 有 当前 程序 集 内 部 的 代码 才能 访问 它 ,其 他 程序 集中 的 代码 是 无 法 访问 的 。 
因此 ,如 果 希 望 所 声明 的 类 能 够 被 所 有 外 部 代码 访问 ,应 该 明确 使 用 public 修饰 符 , 即 声明 
为 公共 类 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 在 生成 的 默认 命名 空间 下 声明 三 个 公共 类 。 


public class ant { } 


public class Dragonfly { } 
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public class Spider { } 
步骤 3: 在 Main 方法 中 ,分 别 使 用 上 面 声 明 的 三 个 类 来 定义 变量 ,并 初始 化 为 默认 值 。 


Rnt v1 = default(Ant); 
Dragonfly v2 = default(Dragonfly); 
Spider v3 = default(Spider); 


注意 : 如 果 省 略 public 修饰 符 ,默认 的 可 访问 性 为 internal, 即 只 有 当前 程序 集 内 部 的 代码 
才能 访问 。 


实例 55 ”为 结构 定义 构造 困 数 

【导语 】 

结构 不 允许 声明 无 参数 的 构造 函数 ,因此 如 果 结 构 需 要 声明 构造 函数 ,必须 声明 带 参数 
的 构造 函数 。 一般 来 说 ,构造 函数 的 参数 用 于 初始 化 结构 中 的 字段 值 。 

由 于 结构 是 值 类 型 ,所 以 声明 变量 后 , 既 可 以 使 用 new 运算 符 来 创建 实例 ,也 可 以 省 
略 。 值 类 型 存储 在 栈 内 存 中 ,声明 变量 后 会 自动 分 配 空间 ,无 须 显 式 创建 实例 。 

【操作 流程 】 

步骤 1: 新建 控制 台 应 用 程序 项 目 。 

步骤 2: 在 项 目 模板 生成 的 默认 命名 空间 下 声明 一 个 Rectangle 结构 。 


struct Rectangle 
{ 
public int Width; 
public int Height; 
} 
结构 包含 两 个 公共 字段 (结构 可 以 包含 属性 ,但 常用 字段 ) ,一 般 应 该 添加 public 修饰 
符 ,以便 其 他 代码 能 访问 字段 。 
步骤 3: 为 Rectangle 结构 定义 带 两 个 参数 的 构造 函数 ,这 两 个 参数 用 来 初始 化 公共 字 
段 的 值 。 


Struct Rectangle 
public int Width; 
public int Height; 


public Rectangle( int w, int h) 
L 

Width = w; 

Height = h; 
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步骤 4: 在 Main 方法 中 ,可 以 通过 三 种 方式 创建 Rectangle 结构 的 实例 。 


// 无 须 使 用 new 运算 符 
Rectangle rl1; 

rl.Width = 10; 
rl.Height = 25; 


// 显 式 使 用 new 运算 符 
Rectangle r2 = new Rectangle(); 
r2.Width = 6; 

r2.Height = 17; 


// 使 用 带 参数 的 构造 函数 
Rectangle r3 = new Rectangle(45, 185); 


实例 56 ”构造 函数 的 相互 调用 

【导语 】 

当 一 个 类 中 存在 多 个 构造 函数 时 ,可 能 会 出 现 构造 函数 之 间 互 相 调 用 的 情况 。 其 格式 
为 : 在 当前 构造 函数 后 紧 跟 一 个 半角 冒号 ,然后 使 用 this 关键 字 调 用 其 他 构造 函数 。 例 如 ， 
和 类 有 两 个 版 本 的 构造 函数 , 则 可 以 使 用 以 下 方式 调用 其 构造 函数 。 


public A() 
:this(1000) 


{ 
} 


public A(int n) 


public int Num { get; set; } 


注意 : 在 一 个 构造 函数 中 访问 其 他 构造 函数 ,必须 在 进入 函数 体 之 前 发 生 , 即 在 一 个 构造 函 
数 的 内 部 是 不 能 访问 其 他 构造 函数 的 。 


【操作 流程 】 
步骤 1: 新 建 控制 台 应 用 程序 项 目 。 
步骤 2: 如 代码 清单 4-1 所 示 , 声 明 一 个 Production 类 ,该 类 包含 三 个 构造 函数 。 
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代码 清单 4-1 Production 类 


/// < summary> 

/// 产品 类 

/// </sunmary> 

public class Production 


| 


/// < sunmary> 

/// 产品 编号 

/// </summary> 

public Guid ProductID { get; set; } 


/// < summary> 

/// 产品 名 称 

/// </summary> 

public string ProductName { get; set; } 


/// < summary> 

/// 生产 日 期 

/// </summary> 

public DateTime ProductDate { get; set; } 


/// < sunmary> 
/// 带 三 个 参数 的 构造 函数 
/// </summary> 
/// <param name = "pid"> 产 品 编号 </param> 
/// < param name = "pname"> 产 品名 称 </param> 
/// < param name = "pdate"> 生 产 日 期 </param> 
public Production(Guid pid，string pname，DateTime pdate) 
{ 

ProductID = pid; 

ProductName = pnane; 

ProductDate = pdate; 
} 


/// < sunmary> 

/// 带 两 个 参数 的 构造 函数 

/// </summary> 

/// <param name = "pname"> 产 品名 称 </param> 

/// < param name = "pdate"> 生 产 日 期 </param> 

public Production( string pname, DateTime pdate) 
:this(Guid. NewGuid(), pnane, pdate) 

{ 


} 
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/// < summary> 
/// 不 带 参数 的 构造 函数 
/// </summary> 
public Production() 
:this(Guid. NewGuid(), "未 知 产品 "，DateTime. Today) 
{ 


} 
} 


三 个 构造 函数 分 别 为 : 


// 没有 参数 的 构造 函数 
public Production(); 


// 带 两 个 参数 的 构造 函数 


public Production( string pname, DateTime pdate); 


// 带 三 个 参数 的 构造 函数 
public Broduction(Guid pid, string piane, DateTine pdate) 
其 中 ,只 有 带 三 个 参数 的 构造 函数 才 有 实现 代码 (通过 参数 给 三 个 属性 赋值 ) ,其 他 两 个 构造 
函数 都 是 调用 这 个 构造 函数 ,因此 另外 两 个 构造 函数 的 方法 体内 部 没有 实现 代码 。 
步骤 3: 回 到 Main 方法 ,分 别 使 用 不 同 版 本 的 构造 函数 对 Production 类 进行 实例 化 。 
// 调用 无 参数 的 构造 函数 
Production pl = ren Production(); 


Console. WriteLine( $ "产品 编号 : {pl. ProductID}\n 产品 名 称 :{p1. ProductName}\n 生产 日 期 :{pl. 
ProductDate:D} \n"); 


// 调用 有 两 个 参数 的 构造 函数 

Production p2 = new Production(" 示 例 产品 "，new DateTime(2017, 12, 12)); 

Console. WriteLine( $ "产品 编号 :{p2. ProductID}\n 产品 名 称 :{p2. ProductNamej\n 生产 日 期 :{p2. 
ProductDate:D}\n"); 


步骤 4: 按 F5 快捷 键 ,运行 应 用 程序 ,输出 结果 如 图 4-1 所 示 。 


图 4-1 调用 不 同 版 本 的 构造 函数 
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实例 57 静态 构造 函数 


【导语 】 

可 以 直接 访问 静态 成 员 ,无 须 创 建 对 象 实例 ,但 不 要 误 以 为 没有 静态 构造 函数 。 常 规 的 
构造 函数 是 在 对 象 实例 化 时 创建 的 ,而 静态 构造 函数 则 是 在 静态 成 员 首次 被 访问 时 创建 的 。 

静态 构造 函数 在 应 用 程序 运行 期 间 一 旦 被 调用 ,其 后 不 论 代 码 是 否 多 次 访问 静态 成 员 ， 
都 不 会 再 调用 静态 构造 函数 。 如 果 代 码 从 不 访问 静态 成 员 ,那么 静态 构造 函数 永远 不 会 被 
调用 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 类 ,并 在 类 中 定义 一 个 静态 属性 。 


public class Test 


{ 
public static string Sample { get; } 


该 属性 只 有 get 访问 器 ,表示 它 是 只 读 属性 。 
步骤 3: 在 类 中 定义 静态 构造 函数 ,在 构造 函数 内 部 为 静态 属性 初始 化 。 


static Test() 
{ 

Sample = "演示 属性 "; 

Console. WriteLine(" 静 态 构 造 函 数 被 调用 。"); 
} 


步骤 4: 回 到 Main 方法 ,对 静态 属性 进行 三 次 访问 。 


Console. WriteLine(Test. Sample); 
Console. WriteLine( Test. Sample); 
Console. WriteLine(Test. Sample); 


步骤 5: 按 F5 快捷 键 运行 项 目 ,从 输出 结果 可 以 看 
到 ,尽管 静态 成 员 被 访问 了 三 次 ,但 是 只 调用 了 一 次 静态 
构造 函数 ,如 图 4-2 所 示 。 


4-2 ”静态 构造 函数 只 调用 一 次 


注意 : 静态 构造 函数 一 般 用 于 初始 化 静态 成 员 , 尤 其 是 只 读 ( 使 用 readonly 关键 字 修 饰 ) 
字段 。 
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实例 58 验证 属性 值 的 有 效 性 

【导语 】 

属性 的 声明 有 一 种 简练 的 语法 ,例如 : 

public int NewValue { get; set; } 
要 把 属性 声明 为 只 读 模式 ,可 以 按 以 下 格式 去 掉 set 请 句 。 

public int NewValue { get; } 

这 种 语法 优点 是 简练 明了 ,但 有 些 时 候 并 不 太 适 用 ,最 典型 的 情况 就 是 代码 对 属性 值 进 
行 验证 。 这 种 情况 就 需要 显 式 地 声明 一 个 私有 字段 来 保存 属性 值 (简练 语法 在 编译 时 会 由 
编译 器 自动 生成 存储 属性 值 的 字段 ) ,并 在 属性 的 set 访问 器 中 对 属性 的 赋值 进行 检查 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 User 类 ,其 中 包含 两 个 string 类 型 的 属性 ,并 且 在 为 属性 赋值 时 需要 
验证 字符 串 的 长 度 。 如果 字 符 串 的 长 度 不 符合 要 求 ,代码 会 抛 出 异常 , 详 见 代 码 清 单 2。 

代码 清单 4-2 User 类 


class User 
{ 
string _userName; 
public string Username 
{ 
get { return _userName; } 
set 
' 
if(value. Length > 15) 
{ 
throw new ArgumentException(" 用 户 名 长 度 不 能 超过 15 个 字符 "); 
} 


_userName = value; 


} 


string _password; 
public string Password 
{ 
get { return _password; } 
set 
{ 
if(value. Length < 8) 
{ 
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throw new ArgumentException( "密码 长 度 至 少 要 8 位 "); 
} 


_password = value; 


} 


value 是 一 个 语言 关键 字 , 它 是 一 个 特殊 的 临时 变量 ,用 来 存放 属性 的 赋值 。 

Username 属性 的 值 最 终 由 _userName 字段 来 存储 ,Password 属性 的 值 由 _password 
字段 来 存储 。 在 set 访问 器 中 保存 属性 值 之 前 进行 检查 ,如 果 符 合 要 求 就 把 value 变量 的 值 
赋 给 用 来 存放 属性 值 的 字段 。 

步骤 3: 回 到 项 目 模 板 生成 的 Main 方法 ,实例 化 一 个 User 对 象 。 


User u = new User(); 
步骤 4: 尝试 对 User 实例 的 属性 赋值 。 


try 
{ 
u. Username = "Tom"; 
.Password = "x*xx%%% 
} 
catch( Exception ex) 
{ 
Console. WriteLine( $ "错误 : {ex. Message} 。"); 


} 

因为 向 属性 赋值 的 过 程 中 可 能 会 出 现 异常 ,所 以 把 赋 
值 的 代码 写 在 try 语句 块 中 ,并 在 catch 子 语句 中 捕捉 可 能 
发 生 的 异常 。 

步骤 S: 运行 项 目 ,由 于 为 Password 属性 所 赋值 的 长 
度 小 于 8, 在 对 属性 值 验证 时 会 发 生 蜡 常 ,所 以 输出 如 


图 4-3 所 示 的 内 容 。 图 4-3 属性 值 未 通过 验证 
实例 59 初始 化 只 读 字 段 
【导语 】 


只 读 字段 与 常量 不 同 ,常量 必须 在 声明 时 赋值 ,而 且 不 能 使 用 表达 式 的 运算 结果 赋值 
(例如 ,不 能 把 某 个 变量 的 值 赋 给 常量 ) ,但 只 读 字段 是 可 以 使 用 其 他 表达 式 的 运算 结果 来 赋 
值 的 。 只 读 字段 和 常量 有 一 个 共同 点 一 一 初始 化 之 后 不 能 在 代码 中 修改 。 

初始 化 只 读 字段 有 两 种 方法 : 第 一 种 是 在 声明 之 后 立即 赋值 ; 第 二 种 是 先 声明 字段 ， 
然后 在 类 构造 函数 中 赋值 。 
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【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 类 ,并 添加 一 个 只 读 字段 。 
class SoneType 

{ 


public readonly string GenericKey; 
} 


步骤 3: 在 类 构造 函数 中 为 只 读 字段 赋值 ,并 且 所 赋 的 值 来 自传 递 给 构造 函数 的 参数 。 


class SoneType 
{ 
public readonly string GenericKey; 


public SomeType( string key) 
{ 
GenericKey = key; 
} 
} 


步骤 4: 在 Main 方法 中 实例 化 上 述 类 。 
SomeType s = new SoneType("000— 862—2—1515"); 


步骤 5: 此 时 ,如 果 试 图 修改 GenericKey 字段 就 会 发 生 错 误 ,因为 它 是 只 读 的 。 


s.GenericKey = "355— 15414"; 
步骤 6: 虽然 不 能 修改 ,但 允许 读 取 。 


Console. WriteLinel(s. GenericKey); 


实例 60 重 载 方法 


【导语 】 

重 载 方法 是 指名 称 相同 ,但 参数 的 数据 类 型 或 个 数 不 相同 的 一 组 方法 。 以 下 情形 可 以 
构成 重 载 : 

(1) 参数 个 数 相同 ,但 类 型 不 同 。 例 如 : 

public void Play(int x) { } 

public void Play(float x) { } 
以 上 两 个 Play 方法 ,都 有 一 个 x 参数 ,但 其 中 一 个 是 int 类 型 , 另 一 个 是 float 类 型 。 由 于 
数 类 型 不 同 ,上 述 两 个 方法 可 以 构成 重 载 。 

(2) 参数 个 数 不 同 ,例如 : 


只 
中 


82 二 | .NET Core 实战 一 -手把手 教 你 掌握 380 个 精彩 案例 


void WorkAs(string args, int tines) { } 
void WorkAs(string args) { } 
void WorkAs() { } 

上 述 三 个 方法 ,参数 个 数 分 别 为 3 个 ,1 个 和 0 个 ,可 以 构成 重 载 。 
但 是 仅 凭 返回 值 类 型 的 差异 是 无 法 构成 重 载 的 。 例 如 : 
byte[ ] GetData( int start, int end) { } 
long GetData( int start, int end) { } 

上 述 两 个 方法 参数 个 数 和 类 型 都 相同 ,虽然 返回 值 类 型 不 同 ,但 是 它们 无 法 构成 重 载 ,因为 

编译 器 无 法 根据 返回 类 型 来 判定 调用 哪个 重 载 。 

【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 在 项 目 模板 生成 的 默认 命名 空间 中 定义 一 个 Test 类 。 


class Test 


{ 


} 
步骤 3: 在 类 中 定义 三 个 重 载 的 Compute 方法 。 


class Test 


{ 

public int Compute( int a) 
returna * 1; 
public int Compute(int a, int b) 


{ 


returna * b; 


public int Compute(int a, int b, int c) 


returna * bx oe; 


中 

带 一 个 参数 的 版 本 会 将 参数 乘 以 1 后 返回 ; 带 两 个 参数 的 版 本 会 将 两 个 参数 相 乘 后 返 
回 ; 带 三 个 参数 的 版 本 会 将 三 个 参数 相 乘 后 返回 。 

步骤 4: 回 到 Main 方法 ,尝试 调用 以 上 三 个 重 载 的 Compute 方法 。 


Testt = new Test(); 
int rl = 七 .Compute(5) 7 
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int r2 = t.Compute(5, 5); 
int r3 = t.Compute(5, 5, 5); 
Console. WriteLine(" 三 个 计算 结果 分 别 为 :{0}, {1}, {2}", rl, r2, r3); 


步骤 5: 项 目 运行 后 ,输出 以 下 结果 : 

三 个 计算 结果 分 别 为 :5,25,125 

实例 61 类 实例 传递 给 方法 后 为 什么 没有 被 更 改 
【导语 】 


先 来 看 一 段 让 许多 初学 者 疑惑 的 代码 。 
首先 声明 一 个 Product 类 ,用 于 做 测试 。 


class Product 
public string Name { get; set; } 
public int Code { get; set; } 

} 


然后 定义 一 个 Update 方法 ,参数 是 一 个 Product 对 象 ,在 方法 内 部 ,让 参数 变量 引用 一 
个 新 的 Product 实例 。 


void Update(Product p) 
{ 
p = new Product 
{ 
"测试 产品 C"， 
700021 


Name 
Code 


}; 


实例 化 一 个 Product 对 象 。 


Product pro = new Product(); 
pro. Name = "测试 产品 A"; 
pro. Code = 60009; 


调用 Update 方法 ,并 传递 上 面 的 实例 。 

Update( pro); 

此 时 读者 一 定 会 认为 ,pro 变量 所 引用 的 应 该 是 Update 方法 中 创建 的 新 实例 , 即 Name 
属性 为 “测试 产品 C”。 而 实际 上 ,pro 变量 的 Name 属性 依然 是 “测试 产品 A”,Code 属性 依 
然 是 60009。 

这 样 就 出 现 疑惑 了 ,既然 类 是 引用 类 型 , 那 为 什么 调用 Update 方法 后 ,变量 pro 所 引用 
的 仍然 是 原来 的 Product 实例 呢 ? 这 是 因为 : 变量 本 身 是 存储 在 栈 内 存 中 的 , 当 把 变量 pro 
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传递 给 Update 方法 时 ,变量 pro 是 把 自身 复制 了 一 份 交 给 方法 的 p 参数 。 如 果 在 Update 
方法 中 没有 让 p 参数 引用 新 的 Product 实例 ,而 只 是 修改 了 p 参数 所 引用 的 实例 属性 ,那么 
当 Update 方法 返回 后 ,pro 变量 和 p 参数 中 所 存储 的 引用 地 址 相同 ,因此 ,方法 内 部 所 作 的 
修改 在 方法 外 部 会 生效 。 然 而 ,前 面 的 实例 代码 是 在 Update 方法 中 让 p 参数 引用 了 一 个 
新 的 Product 实例 ,如 此 一 来 ,pro 变量 和 p 参数 中 所 存储 的 引用 就 不 是 同一 个 地 址 了 , 即 它 
们 引用 了 不 同 的 Product 实例 。 所 以 在 调用 Update 方法 之 后 ,再 去 访问 pro 变量 ,实际 上 
访问 的 还 是 旧 的 Product 实例 ,而 非 新 创建 的 实例 。 这 就 使 得 Update 方法 内 部 所 做 的 修改 
在 方法 外 部 无 效 。 

本 实例 将 演示 如 何 解决 这 个 问题 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Product 类 。 


class Product 

{ 
public string Name { get; set; } 
public int Code { get; set; } 

} 


步骤 3: 在 Program 类 中 定义 Update 方法 。 


static void Update( ref Product p) 
{ 

p = new Product 

t 


Name =“" 测 试 产品 C"， 
Code = 700021 


注意 : 在 定义 方法 参数 的 时 候 要 加 上 ref 关键 字 , 这 样 变量 在 传递 给 方法 时 ,就 会 将 自身 作 
为 引用 来 传递 ,而 不 是 复制 自身 。 


步骤 4: 在 Main 方法 中 实例 化 一 个 Product 对 象 。 


Product pro = new Product 
{ 
Name =“" 测 试 产品 A"， 
Code = 60009 
}; 


步骤 5: 为 了 便于 对 比 ,在 调用 Update 方法 前 ,先进 行 一 次 屏幕 输出 。 


Console. WriteLine( $ "调用 Update 方法 前 。\nName = {pro. Name},Code = {pro.Code}\n\n"); 
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步骤 6: 调用 Update 方法 ,并 传递 变量 。 

Update( ref pro); 

步骤 7: 在 调用 Update 方法 后 ,再 进行 一 次 屏幕 
输出 。 


Console. WriteLine( $ "调用 Update 方法 后 。\nName = 
{pro. Name}, Code = {pro. Code}"); 


步骤 8: 按 下 快捷 键 F5 运行 项 目 ,图 4-4 可 以 对 
比 Update 调用 方法 前 后 的 输出 。 


图 4-4 Update 方法 调用 前 后 对 比 


注意 : 在 调用 带 有 ref 关键 字 的 方法 时 ,也 要 使 用 ref 关键 字 。 


实例 62 输出 参数 


【导语 】 

在 声明 方法 的 输出 参数 的 时 候 需 要 加 上 out 关键 字 ,在 调用 的 时 候 也 需要 加 上 out 关 
键 字 。 要 接收 方法 输出 的 参数 值 ,必须 在 方法 外 部 定义 一 个 变量 。 假 设 Run 方法 有 一 个 布 
尔 类 型 的 输出 参数 ,调用 方法 如 下 : 


bool outResult; 
Run ( out outResult ) ; 


其 中 ,outResult 变量 用 于 接收 输出 参数 。 为 了 提升 编写 代码 的 效率 ,还 可 以 把 上 面 的 写法 
合并 成 以 下 语句 。 


Run ( out bool outResult ); 
【操作 流程 】 


步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 在 Program 类 中 定义 一 个 带 输出 参数 的 方法 。 


static void Work(double x, double y, out double result) 
{ 
Peenlt 去 无 十 到 
} 
result 是 输出 参数 ,声明 时 要 加 上 out 关键 字 。 
步骤 3: 在 Main 方法 中 进行 调用 。 
double r; 
Work(2. 001d, 0.855d, out r); 


还 可 以 这 样 调用 。 
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Work(2. 001d, 0.885d, out double r); 

步骤 4: 输出 调用 结果 。 

Console. WriteLine(" 计 算 结 果 :{0}",r); 

步骤 5: 运行 后 ,控制 台 窗 口 输 出 以 下 信息 。 


计算 结果 :2. 886 


注意 : 输出 参数 的 功能 与 返回 值 有 些 类 似 , 而 且 也 可 以 在 一 个 方法 中 同时 使 用 返回 值 和 给 
出 参数 。 但 是 返回 值 只 能 是 一 个 单一 对 象 , 如 果 需 要 方法 返回 不 同 数 据 类 型 的 结果 ， 
就 应 当 使 用 输出 参数 ,因为 一 个 方法 可 以 定义 多 个 输出 参数 ,但 不 能 定义 多 个 返 


回 值 。 


实例 63 ”可 变 个 数 的 方法 参数 


【导语 】 


在 声明 方法 参数 时 ,可 以 使 用 数组 类 型 的 参数 ,并 且 在 前 面 加 上 params 关键 字 。 这 表 
明 在 调用 方法 时 ,可 以 直接 输入 要 传递 给 数组 参数 的 值 ( 即 直接 传 数 组 元 素 ) ,每 个 元 素 之 间 


用 英文 的 逗号 隔 开 ,与 传递 普通 参数 一 样 。 


由 于 params 关键 字 所 修饰 的 参数 是 数组 类 型 ,所 以 参数 个 数 是 可 变 的 ,也 可 以 是 0 个 。 
为 了 让 编译 器 能 够 识别 可 变 个 数 的 参数 ,一 个 方法 中 只 能 使 有 一 次 用 params 关键 字 修 饰 的 


参数 ,而 且 该 参数 必须 位 于 方法 参数 列表 的 最 后 ,其 后 面 不 能 出 现 其 他 参数 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 在 生成 的 Program 类 中 定义 一 个 方法 。 


static void Sample(params int[ ] numbers) 
{ 

Console. WriteLine("\n 参数 列表 :"); 

foreach( int i in numbers) 

{ 

Console. Write("{0}", i); 

} 

} 


该 方法 上 只 有 一 个 参数 ,类 型 是 int 数组 ,并且 带 有 params 关键 字 , 说 明 它 是 


数 的 参数 。 
步骤 3: 在 Main 方法 中 测试 对 上 述 方法 的 调用 。 


Sample(1, 2, 3, 4, 5); 
Sample(9, 8); 


-个 可 变 个 
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第 一 次 调用 传递 了 5 个 参数 ,第 二 次 调用 传递 了 2 个 参数 。 


注意 : 传递 参数 时 ,一 定 要 使 用 类 型 匹配 的 值 。 例 如 上 面 的 Sample 方法 ,需要 的 参数 均 为 
int 类 型 ,调用 时 就 不 能 给 参数 传递 string 类 型 的 实例 。 


步骤 4: 运行 应 用 程序 ,两 次 调用 Sample 方法 所 输出 的 内 
容 如 图 4-5 所 示 。 


实例 64 ”使 用 按 引用 传递 的 返回 值 


【导语 】 

除了 可 以 使 用 按 引用 传递 的 输入 参数 外 ,还 可 以 使 用 按 引 图 4-5 调用 带 可 变 个 
用 传递 的 返回 值 。 与 按 引用 传递 的 输入 参数 相似 , 按 引用 传递 数 参数 的 方法 
的 返回 值 也 使 用 ref 关键 字 。 例 如 以 下 方法 就 可 以 按 引 用 传递 
返回 的 数据 。 


ref string GetName ( int index ); 


调用 上 述 方法 时 ,需要 一 个 按 引 用 赋值 的 变量 来 获取 返回 的 内 容 ,为 了 让 这 个 变量 能 够 
按 引 用 赋值 ,在 声明 的 时 候 也 要 加 上 ref 关键 字 。 如 以 下 代码 所 示 。 


ref string resStr = ref GetName ( 1 ); 


如 果 变 量 是 按 引用 赋值 ,那么 当代 码 修改 变量 所 指向 的 对 象 时 ,变量 所 引用 的 内 容 也 会 
同步 被 修改 。 

当 要 返回 的 对 象 包含 比较 复杂 的 数据 时 (尤其 是 结构 , 它 会 自我 复制 ), 可 以 将 其 按 引 用 
方式 返回 ,以 节省 对 象 数据 在 复制 过 程 中 的 性 能 开销 。 使 用 按 引用 传递 的 返回 值 时 ,需要 注 
意 以 下 几 点 : 

(1) 当 方法 (或 属性 ?要 按 引 用 返回 时 ,必须 有 一 个 变量 来 存放 对 象 引 用 ,并 且 该 变量 的 
生命 周期 必须 大 于 该 方法 (属性 )。 也 就 是 说 ,在 方法 (属性 ) 内 部 声明 的 变量 是 不 能 按 引 用 
返回 的 ,因为 当 方 法 (属性 ) 返 回 后 变量 的 生命 周期 就 结束 了 ,所 以 这 个 变量 应 当 是 类 (或 结 
构 ) 级 别 的 字段 (一 般 是 私有 字段 )。 

(2) 不 能 直接 返回 null, 和 否则 会 发 生 错误 。 因 为 该 值 无 任何 引用 ,无 法 进行 传递 。 但 是 
用 来 存放 引用 的 变量 是 可 以 为 null 的 ,例如 类 级 别 的 一 个 字段 可 以 赋 null 值 , 当 该 字段 被 
作为 按 引 用 传递 的 返回 值 时 不 会 发 生 错 误 。 

(3) 使 用 ref 关键 字 声 明 的 变量 ,可 以 引用 单个 对 象 实例 ,也 可 以 引用 数组 中 的 某 个 元 
素 ,但 不 能 引用 List < T > 对 象 中 的 元 素 。List< 工 > 对 象 不 是 直接 访问 元 素 实例 , 它 内 部 有 
封装 和 传递 变量 的 过 程 , 而 由 于 数组 是 可 以 直接 引用 元 素 实 例 的 ,因此 数组 中 的 元 素 可 以 被 
ref 关键 字 声 明 的 变量 引用 。 

为 了 更 好 地 对 比 普通 返回 值 与 按 引用 传递 的 返回 值 之 间 的 不 同 ,本 实例 声明 了 两 个 基 
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本 相同 的 类 ,类 中 都 封装 一 个 int 类 型 的 私有 字段 ,并 通过 Value 属性 公开 该 字段 的 值 。 而 


这 两 个 类 的 差异 就 在 于 Value 属性 的 返回 方式 ,一 个 是 普通 的 按 值 返回 , 另 
返回 。 
【操作 流程 】 
步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 定义 两 个 类 一 一 Testl 和 Test2。 详 见 代码 清单 4-3。 
代码 清单 4-3 ”Testl 类 与 Test2 类 


-个 则 是 按 引用 


class Test1 
{ 


private int local; 


public Test1(int init) 
人 
_local = init; 


} 


public void DisplayValue() 
Console. WriteLine( $ "当前 值 :{_localj"); 
} 


public int Value => _local; 
} 


class Test2 
{ 


private int _local; 


public Test2(int init) 
{ 
_local = init; 


} 


public void DisplayValue( ) 
{ 

Console. WriteLine( $ "当前 值 :{_local}"); 
} 


public ref int Value => ref _local; 


} 


当 使 用 ref 关键 字 声 明了 方法 (或 属性 ) 后 ,在 返回 内 部 代码 时 也 要 加 上 ref 关键 字 。 
步骤 3: 在 Main 方法 中 ,分 别 对 这 两 个 类 进行 测试 ,如 代码 清单 4-4 所 示 。 
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代码 清单 44 ”对 比 按 值 返回 与 按 引用 返回 
WriteLine(" -一 不 使 用 按 引 用 传递 的 返回 值 ------- "); 


Testl tl1 = new Test1(100); 
WriteLine(" 初 始 值 :"); 
t1.DisplayValue(); 

int x = tl1.Value; 

x = 200; 

WriteLine(" 修 改 属性 返回 值 之 后 :"); 
t1.DisplayValue(); 


WriteLine("\n—-———-—— 使 用 按 引用 传递 的 返回 值 -一 - “ha 
Test2 t2 = new Test2(100); 

WriteLine(" 初 始 值 :"); 

t2.DisplayValuel ) ; 

ref int y = ref t2.Value; 

Y = 200; 

WriteLine(" 修 改 属性 返回 值 之 后 :"); 

t2. DisplayValue(); 


步骤 4: 运行 项 目 , 输 出 结果 如 图 4-6 所 示 。 


100 
民 回 值 之 后 ， 


4-6 两 种 返回 方式 的 输出 结果 


当 返 回 值 是 按 值 传递 时 ,会 复制 一 份 _ local 变量 所 指向 的 实例 ,然后 返回 新 实例 ,修改 
Value 属性 所 返回 的 值 时 ,实际 上 修改 的 是 复制 后 的 实例 ,因此 _local 字段 的 值 仍然 是 100。 

当 返 回 值 是 按 引用 传递 时 ,就 相当 于 为 local 字段 创建 一 别名”, 由 于 Value 属性 返 加 
的 是 引用 ,因此 当 返 回 的 值 被 修改 后 ，local 字段 的 值 也 同步 被 修改 。 

实例 65 ” 按 参 数 名 称 来 传 什 

【导语 】 

假设 有 如 下 方法 。 


int add ( int a, intb ) 


- 般 情 况 下 ,在 调用 方法 时 都 是 将 参数 按照 其 定义 的 顺序 进行 传递 ,例如 : 
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int x = Add (1, 2); 

这 时 候 , 数 值 1 会 自动 传递 给 a 参数 ,数值 2 会 自动 传递 给 参数 b。 
但 是 如 果 和 希望 把 2 传递 参数 a, 把 1 传 给 参数 b, 当 然 最 简单 的 方法 是 把 位 置 调换 一 下 。 
Add(2, 1); 


还 有 一 种 方法 ,就 是 按 参 数 的 命名 来 传递 , 即 在 传递 参数 时 明确 指定 参 
代码 也 可 以 写成 如 下 形式 。 


中 


数 的 名 字 , 上 面 


add (a:2, b:1); 

或 

add (b:1, a:2); 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 本 例 以 调用 Math 类 的 Min 方法 为 例 。 首先 通过 常规 调用 方法 ,直接 按 参 数 声 
明 的 顺序 传递 即 可 。 

int x = Math.Min(5, 13); 

步骤 3: 也 可 以 通过 参数 名 称 来 显 式 指 定 参数 值 。 


int y = Math.Min(val1: 2, val2: 6); 
// 或 者 


int z = Math.Min(val2: 17, vall: 58); 

参数 名 称 与 参数 值 之 间 , 用 一 个 半角 冒号 来 分 隔 。 

实例 66 “可 选 参数 

【导语 】 

在 定义 参数 的 同时 分 配 一 个 默认 值 , 该 参数 就 成 为 可 选 参数 。 可 选 参数 在 调用 时 可 以 
明确 赋值 ,也 可 以 忽略 。 如 果 可 选 参数 在 调用 时 被 忽略 , 则 保留 其 默认 分 配 的 值 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 一 个 带 有 两 个 可 选 参 数 的 方法 。 


static void Something( int pl, byte p2 = 255, bool p3 = false) 
{ 
string msg = "参数 列表 \n" + 
$ "{nameof(p1)} = {pl}\n{nameof(p2)} = {p2}\n{nameof(p3)} = {p3}\n"; 
Console. WriteLine(nsg); 


} 
其 中 ,pl 是 必须 参数 ,在 调用 时 必须 赋值 ,p2 和 p3 是 可 选 参数 ,在 调用 时 可 以 忽略 。 
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接 下 来 将 进行 调用 演示 。 

步骤 3: 调用 上 述 方法 ,并 为 所 有 参数 赋值 。 

Something(20, 100, true); 

步骤 4: 只 为 第 一 个 可 选 参数 赋值 。 

Something(31, 1); 

此 时 ,pl 参数 的 值 为 31,p2 是 可 选 参数 ,默认 分 配 的 值 为 255， 
由 于 此 处 明确 赋值 ,所 以 p2 的 值 变 为 1,p3 参数 也 是 可 选 参数 , 仍 保 
持 默认 值 false。 

步骤 5: 只 为 二 个 可 选 参数 赋值 , 即 pl 和 p3 两 个 参数 ,p2 参数 
被 忽略 。 

Something(p1: 65, p3: true); 

由 于 第 二 个 参数 被 忽略 ,因此 这 里 要 通过 参数 的 名 称 赋值 ,以 下 
调用 的 语法 错误 。 


Something(900, , true); 


步骤 6: 按 F5 快捷 键 运 行 项 目 , 输 出 结果 如 图 4-7 所 示 。 
实例 67 在 声明 时 初始 化 属性 


【导语 】 
属性 可 以 使 用 以 下 简化 的 代码 来 声明 。 


图 4-7 调用 可 选 参 数 


public string Code { get; set; } 
如 果 需 要 ,可 以 在 声明 后 立刻 对 属性 进行 初始 化 ,例如 以 下 代码 。 
public string Code { get; set; } = "C— 000"; 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 类 ,此 类 包含 三 个 公共 属性 ,并 在 声明 属性 时 进行 初始 化 。 


class Student 
{ 
public long ID { get; set; } = OL; 
public string Name { get; set; } = "新 学 员 "; 


public string Course { get; set; } = "Visual Basic"; 
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注意 : 因为 对 属性 初始 化 时 使 用 的 是 赋值 语句 ,所 以 后 面 要 写 上 半角 分 号 ,表示 代码 行 
结束 。 


步骤 3: 使 用 上 面 定 义 的 类 实例 化 一 个 对 象 ,实例 化 之 后 不 对 属性 赋值 ,而 是 直接 输出 
到 屏幕 上 。 

Student stu = new Student(); 

WriteLine(" 学 员 编 号 : {0} \n 学 员 姓 名 :{1}\n 学 习 课 程 : {2}"，stu. 

ID, stu. Name, stu. Course); 

步骤 4: 运行 应 用 程序 项 目 ,就 能 看 到 各 个 属性 的 默认 值 输 
出 到 屏幕 上 了 ,如 图 4-8 所 示 。 


图 4-8 属性 的 默认 值 


4.2 ”委托 与 事件 
实例 68 ”委托 实例 如 何 绑 定 方法 
【导语 】 


委托 是 一 种 数据 类 型 (属于 引用 类 型 ) , 它 的 声明 类 似 于 方法 ,但 委托 不 包含 任何 方法 的 
实现 代码 ,因此 在 调用 委托 实例 前 必须 绑 定 方法 。 单 播 委托 只 能 绑 定 一 个 方法 ,多 播 委 托 则 
可 以 绑 定 多 个 方法 。 当 委托 实例 被 调用 时 .与 之 绑 定 的 所 有 方法 都 会 被 调用 。 

某 个 方法 实例 必须 参数 类 型 ,参数 个 数 ,参数 顺序 以 及 返回 类 型 都 与 对 应 的 委托 相 匹配 
时 ,才能 绑 定 在 委托 实例 。 例 如 ,以 下 委托 接受 一 个 string 类 型 的 参数 ,并 且 返 回 类 型 
为 int。 


delegate int Test(string str) 
以 下 方法 不 能 与 Test 委托 实例 绑 定 。 
int Save ( byte[] buffer ); 


虽然 该 方法 返回 int 类 型 的 值 , 但 是 它 的 参数 类 型 是 字 节 数组 ,并非 字符 串 类 型 ,因此 
不 能 与 Test 委托 实例 绑 定 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 委托 ,输入 参数 有 两 个 ,一 个 是 int 类 ,一 个 是 double 类 型 ,返回 值 为 
double 类 型 。 


delegate double DoSomething( int x, double y); 


委托 属于 数据 类 型 » 因 此 可 以 直接 在 命名 空间 下 声明 ,并 使 用 delegate 关键 字 o 
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步骤 3: 在 项 目 模板 生成 的 Program 类 中 定义 一 个 静态 方法 ,用 于 与 上 面 所 定义 的 委 
托 进 行 绑 定 。 


static double RunHere( int a, double b) 
{ 


returna + b; 
} 
无 论 是 静态 方法 还 是 实例 方法 ,只 要 是 可 访问 的 或 者 参数 与 返回 值 匹配 的 ,都 可 以 与 委 
托 实例 进行 绑 定 。 
步骤 4: 实例 化 DoSomething 委托 。 


DoSonething dele = new DoSomething(RunHere) 

委托 对 象 实例 化 时 也 是 使 用 new 运算 符 , 并 且 把 要 绑 定 的 方法 的 名 字 传 递 给 构造 本 
数 。 委 托 实 例 化 还 可 以 用 简化 的 语法 一 一 直接 把 方法 的 名 字 赋 值 给 委托 变量 。 

DoSonething dele = RunHere; 

步骤 5: 委托 实例 的 调用 方式 与 方法 的 调用 一 样 , 可 以 传 参数 ,也 可 以 接收 返回 值 。 


double res = dele(16, 27.67d); 


实例 69” 绑 定 多 个 方法 


【导语 】 

多 播 委托 允许 委托 实例 绑 定 多 个 方法 ,其 基础 类 型 为 MulticastDelegate, 但 是 在 实际 编 
写 代码 时 是 无 须 考虑 该 基 类 的 。 在 代码 中 ,可 以 使 用 “十 ”运算 符 (加 号 ) 添 加 要 绑 定 的 方法 ， 
或 者 使 用 “一 ”运算 符 ( 减 号 ) 移 除 已 绑 定 的 方法 。 

在 多 播 委 托 实例 上 添加 或 移 除 方法 实例 ,使 用 更 多 的 是 “十 二 ”与 “一 二 ”运算 符 。 假设 
某 委 托 实例 变量 名 为 dx, M1 和 M2 是 方法 ,要 让 dx 委托 绑 定 这 两 个 方法 ,可 以 写 为 如 下 
形式 。 

dx = M1; 

dx += M2; 

完整 的 写法 如 下 。 

dx = dx + M2; 


因为 多 个 方法 实例 合并 后 会 产生 新 的 委托 实例 ,使 用 * 十 = 一 ”运算 符 让 委托 实例 与 新 绑 
定 的 方法 组 合 后 产生 的 新 实例 又 赋值 给 dx 变量 ,这 样 就 可 以 使 用 dx 变量 调用 组 合 后 的 委 
托 实例 。 
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【操作 流程 】 
步骤 1: 新建 控制 台 应 用 程序 项 目 。 
步骤 2: 定义 一 个 委托 类 型 。 


delegate void yaunetioa()7 
步骤 3: 在 Program 类 中 定义 两 个 静态 方法 。 


static void Output1() 

Console. WriteLine(" 这 是 第 一 个 方法 "); 
a void Output2() 

Console. WriteLine(" 这 是 第 二 个 方法 "); 
’ 


步骤 4: 在 Main 方法 中 ,用 上 面 定义 的 委托 声明 一 个 变量 ,初始 化 为 null。 


MyFunction del = null; 
步骤 5: 让 委托 变量 绑 定 Outputl 和 Output2 方法 。 


del += Output1; 和 二 一 一 一 一 一 二 
del += Output2; 


步骤 6: 调用 委托 实例 。 

del(); 

步骤 7: 运行 应 用 程序 项 目 . 当 委托 实例 被 调用 ,关联 的 两 个 
方法 也 会 被 调用 ,如 图 4-9 所 示 。 

实例 70 匿名 方法 

【导语 】 
匿名 方法 使 用 delegate 关键 字 作 为 方法 名 ,后 接 方法 参数 列表 以 及 方法 体 。 匿 名 方法 
可 以 做 到 在 不 定义 新 方法 的 前 提 下 直接 给 委托 变量 赋值 。 某 个 委托 类 型 的 声明 如 下 。 


图 4-9 委托 会 同时 调用 
绑 定 的 所 有 方法 


delegate int DoSomething ( int ay int b ); 
在 声明 委托 变量 后 ,可 以 用 匿名 方法 直接 赋值 ,而 不 需要 定义 新 的 方法 来 绑 定 。 


DoSomething d = delegate ( int j, int k ) 
{ 
retiurnj t+ ky 


上 
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【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 一 个 委托 ,委托 返回 void 类 型 ,接受 两 个 double 类 型 的 参数 。 
delegate void Test(double f, double g) ; 

步骤 3: 在 Main 方法 中 ,声明 一 个 委托 变量 ,初始 化 为 null。 

Test td = null; 

步骤 4: 让 委托 变量 绑 定 三 个 匿名 方法 。 


td += delegate (double x, double y) 
{ 


Console. WriteLine( $ "{x} + {y} = {x + y}"); 
td += delegate (double x, double y) 

Console. WriteLine( $ "{x} - {y} = {x — y}"); 
td += delegate (double x, double y) 


Console. WriteLine( $ "{x} x {y} = {x * y}"); 
}; 
步骤 5: 调用 委托 。 
td(0.3d, 0.2d); 
步骤 6: 运行 应 用 程序 项 目 , 当 委托 实例 被 调用 ,三 个 关联 的 ”图 4-10 调用 匿名 方法 
匿名 方法 就 会 被 调用 ,运行 结果 如 图 4-10 所 示 。 


注意 : 如 果 绑 定 的 方法 需要 在 代码 中 多 次 引用 ,就 不 能 使 用 匿名 方法 了 ,因为 匿名 方法 没有 
名 称 ,声明 之 后 在 代码 中 无 法 再 次 引用 。 


实例 71 封装 事件 

【导语 】 

事件 是 类 型 中 的 一 种 成 员 对 象 , 它 是 委托 类 型 。 主 要 是 运用 了 委托 可 以 绑 定 一 个 或 多 
个 方法 的 特点 , 当 作为 事件 的 委托 被 调用 时 ,就 能 连带 地 调用 其 绑 定 的 方法 。 这 样 一 来 ,类 
型 中 的 代码 只 负责 引发 (调用 ) 事 件 , 而 不 需要 考虑 如 何 响应 事件 。 

声明 事件 需要 使 用 event 关键 字 , 例 如 下 面 委托 将 作为 某 个 类 的 事件 类 型 。 


public delegate void TestEventDelegate(object obj, int arg); 


在 类 中 ,可 以 用 以 上 委托 来 定义 事件 。 
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public event TestEventDelegate Play; 


事件 一 般 应 该 声明 为 公共 成 员 ,这 样 才能 方便 外 部 代码 引用 ,以 绑 定 响应 事件 的 方法 
假设 变量 vt 是 某 个 类 的 实例 ,可 以 把 它 的 Play 事件 与 方法 绑 定 。 


tn.Play += delegate (object o, int a) 

! Console. WriteLine(a); 

}; 

只 要 Play 事件 在 类 中 被 调用 ,与 其 绑 定 的 方法 也 会 被 调用 ,这 样 就 达到 了 ” 当 某 件 事情 
发 生 时 ,代码 会 做 出 响应 ”的 效果 。 就 像 上 面 代码 所 演示 的 ,Play 事件 绑 定 了 一 个 匿名 方 
法 ,在 莫名 方法 中 通过 WriteLine 方法 输出 事件 参数 的 值 。 绑 定 方法 后 ,一 旦 Play 事件 被 
调用 ,那么 屏幕 上 就 会 立即 输出 事件 参数 的 值 。 

上 面 所 举例 的 事件 定义 是 直接 公开 事件 委托 的 ,在 某 些 特殊 情况 下 ,也 可 以 像 属性 那 
样 ,把 事件 所 使 用 的 委托 进行 封装 , 即 类 型 的 内 部 用 一 个 私有 字段 来 存储 委托 实例 ,然后 将 
event 关键 字 所 定义 的 事件 对 外 公开 ,但 字段 本 身 不 对 外 公开 。 这 种 封装 一 般 用 在 需要 对 
赋值 给 委托 的 方法 实例 进行 验证 的 场合 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 一 个 委托 ,用 来 作为 事件 类 型 。 


public delegate void DemoEventDelegate(object obj, int count); 


步骤 3: 声明 一 个 测试 类 ,并 包含 事件 成 员 。 


public class Test 
{ 
DemogventDelegate _myEvent; 


public event DemoEventDelegate Worked 
{ 
add 
{ 
_myEvent += value; 


} 


remove 
{ 

_myEvent -= value; 
} 


} 


以 上 代码 中 ,通过 一 个 _myEvent 私有 字段 来 保存 事件 ,对 外 公开 的 事件 是 Worked。 
属性 类 似 , 属 性 通常 用 get 和 set 访问 器 ,而 事件 也 有 两 个 访问 器 一 add 访问 器 用 于 向 


ey 
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作为 事件 的 委托 添加 要 绑 定 的 方法 实例 ; remove 访问 器 用 于 从 作为 事件 的 委托 实例 中 移 除 某 
个 方法 实例 。value 是 一 个 关键 字 , 表 示 赋 值 给 委托 的 值 ,作用 与 属性 中 的 value 关键 字 相 同 。 
步骤 4: 这 种 封装 常用 于 验证 ,例如 在 add 的 时 候 ,可 以 检查 值 是 否 为 null。 


add 
{ 
if(value != null) 
{ 
_myEvent += value; 
} 
} 


步骤 5: 在 类 中 ,需要 用 代码 来 调用 事件 委托 ,这 样 才能 引发 事件 ,此 处 定义 一 个 公开 的 
Run 方法 , 当 方 法 被 调用 时 ,会 调用 事件 委托 ,然后 也 会 调用 与 委托 绑 定 的 所 有 方法 。 

private int ec = 0; 

public void Run() 

{ 

_myEvent?. Invoke(this, ++c); 

} 

每 次 调用 都 会 先 让 c 字段 的 值 加 上 1 再 传递 处 理事 件 的 方法 。 上 面 代码 在 调用 委托 
时 ,在 变量 名 后 面 加 了 一 个 “?”( 英 文 的 问号 ) ,主要 是 用 来 检查 _myEvent 字段 是 否 为 null， 
如 果 为 null 就 不 调用 了 。 运 算 符 “?” 可 以 简化 代码 , 它 相 当 于 如 下 代码 。 


if(_myEvent != null) 
i 

_myEvent(this, ++c); 
} 


步骤 6: 实例 化 用 于 测试 的 类 。 

Test t = new Test(); 

步骤 7: 为 Worked 事件 绑 定 处 理 代 码 , 此 处 使 用 了 Lambda 表达 式 。 
t.Worked += (k, f) => Console.WriteLine( $ "你 已 调用 了 {f} 次 实例 。"); 


当 Worked 事件 发 生 时 会 在 屏幕 上 输出 一 行文 本 。 
步骤 8: 为 了 验证 事件 是 否 会 发 生 ,可 以 连续 调用 4 次 Run 方法 。 


t. Run(); 
t. Run(); 
t. Run(); 
t. Run(); 


步骤 9: 实例 运行 后 的 结果 如 图 4-11 所 示 。 


图 4-11 引发 事件 
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实例 72 框架 提供 的 委托 类 型 


【导语 】 

为 了 提高 开发 人 员 的 效率 (无 须 自 己 定义 过 多 的 委托 类 型 ),. NET 基础 框架 公开 了 许 
多 委托 类 型 ,并 且 这 些 委托 类 型 都 带 有 泛 型 参数 ,可 以 最 大 程度 地 扩充 其 灵活 性 。 这 些 委托 
可 以 分 为 两 类 : 

(1) Action。 用 于 匹配 返回 类 型 为 void 的 方法 ,可 以 匹配 0 到 16 个 参数 的 方法 。 在 实 
际 开 发 中 ,这 已 经 能 够 处 理 绝 大 部 分 的 情形 了 ,通常 很 少 会 定义 参数 过 多 的 方法 。 

(2) Func。 用 于 匹配 返回 类 型 为 非 void 类 型 的 方法 ,同样 也 能 匹配 0 到 16 个 输入 参 
数 。 所 有 Func 委托 的 泛 型 参数 列表 中 ,最 后 一 个 (TResult) 都 表示 方法 的 返回 值 类 型 。 例 
如 ,Func< int，int，string > 可 以 匹配 有 两 个 int 类 型 输入 参数 .返回 值 为 string 类 型 的 
方法 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 项 目 模板 生成 的 Program 类 中 定义 两 个 返回 值 为 void 类 型 的 方法 。 


static void TestA(string nane, int age) 
{ 
Console. WriteLine( $ "{name} 今年 [age} 岁 了 。"); 
} 
static void TestB( String nane) 
Console. WriteLine(" 你 好 , {0}"， nanme); 
} 


步骤 3: 青 定义 两 个 返回 值 为 非 void 类 型 的 方法 。 


static int TestC(DateTine dt) 
{ 
return dt. Year; 
} 
static long TestD( int start, int end) 
{ 
longr = 1L; 
int cur = start; 
while(cur <= end) 
{ 
ry 
Curtt; 
} 


return r; 


的 委 


用 。 
传递 


步骤 4: 使 用 Action 委托 绑 定 TestA 和 TestB 方法 。 


Action< string, int> dl = TestA; 

d1("Bob", 28); 

Action< string> d2 = TestB; 

d2("Jim"); 

通过 泛 型 参数 指定 参数 的 个 数 和 数据 类 型 。 

步骤 5: 使 用 Func 委托 绑 定 TestC 和 TestD 方法。 
Func < DateTime, int> d3 = TestC; 

Console. WriteLine(" 今 年 是 [0} 年 ."， 吧 (DateTime. Now)); 
Func < int, int, long> d = TestD; 

long res = d4(2, 4); 

Console. WriteLine( "计算 结果 :{0}"，res); 

指定 Func 委托 的 返回 类 型 总 是 在 泛 型 参数 的 最 后 一 个 。 
托 , 返 回 类 型 为 long, 因 此 使 用 的 委托 是 Func < int，int， 


实例 73 将 方法 作为 参数 进行 传递 
【导语 了 
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例如 上 面 要 绑 定 TestD 方法 


long >。 


如 果 没 有 委托 类 型 ,是 无 法 将 一 个 方法 作为 参数 进行 传递 的 ,这 也 是 委托 的 另 一 个 作 
因为 委托 本 身 是 类 ,属于 引用 类 型 ,通过 参数 传递 后 , 它 所 绑 定 的 方法 的 引用 也 随 之 被 
。 虽 然 是 间接 地 实现 将 方法 人 为 参数 传递 ,但 也 的 确 能 实现 该 功能 。 


本 实例 以 Predicate 委托 为 例 ,在 一 个 整形 数组 中 查找 


可 以 被 2 或 3 整除 的 整数 。 


Predicate 委托 实例 可 以 用 于 数组 或 列表 类 型 ,主要 功能 是 用 了 
素 的 查找 逻辑 与 集合 对 象 分 开 , 开 发 者 可 以 通过 Predicate 委托 来 绑 定 自 定义 的 查找 方法 。 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 定义 一 个 数组 实例 ,类 型 为 int。 


int[] arr = { 16, 21; 20, 11; 18, 37, 41, 77 }; 


F 查 找 匹配 的 元 素 。 这 使 得 元 


步骤 3: 调用 FindAll 方法 查找 所 有 匹配 的 元 素 , 被 找到 的 元 素 会 组 成 一 个 新 的 数组 并 
返回 。 


int[] resarr = Array.FindAll(arr, element => 


if(((element % 2) == 0) || ((element % 3) == 0)) 
{ 


return true; 
} 


return false; 
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Predicate 委托 的 声明 如 下 : 

public delegate bool Predicate< in T>(T obj); 
该 委托 带 有 一 个 工 泛 型 参数 ,可 以 最 大 限度 地 发 挥 其 灵活 
性 ,返回 类 型 为 布尔 类 型 ,如 果 元 素 找到 就 返回 true, 要 是 
找 不 到 就 返回 false。FindAll 方 法 在 访问 数组 中 的 每 个 元 
素 时 ,都 会 调用 Predicate 委托 实例 并 把 元 素 传递 进去 ,如 


果 返 回 true 表明 是 匹配 的 ,否则 就 是 不 匹配 的 。 图 4-12 输出 数组 中 可 被 
步骤 4: 运行 项 目 ,输出 结果 如 图 4-12 所 示 。 2 或 3 整除 的 整数 
实例 74 使 用 Lambda 表达 式 动 态 产生 数据 
【导语 】 


Lambda 表达 的 作用 与 匿名 方法 相似 .但 书写 起 来 比 匿名 方法 简洁 .而 且 Lambda 方法 
能 够 让 编译 器 自动 推测 参数 的 数据 类 型 ,因此 一 般 只 需要 给 出 参数 名 称 即 可 .不 要 求 明确 指 
定 参 数 的 类 型 。Lambda 表达 式 可 以 直接 赋值 给 委托 变量 。 

Lambda 表达 式 的 格式 如 下 。 

( < 参数 列表 > ) = > < 方法 体 > 

如 果 没 有 参数 ,就 需要 一 对 空白 的 括号 。 

() => < 方法 体 > 

如 果 Lambda 表达 式 的 方法 体 有 多 行 代 码 , 则 需要 写 在 一 对 大 括号 中 。 

本 实例 将 实现 一 个 类 ,类 的 构造 函数 接受 一 个 委托 对 象 , 该 委托 最 后 会 产生 一 个 字典 实 
例 ( 带 键 / 值 对 的 集合 ) ,并 且 该 类 会 公 天 一 个 方法 ,调用 后 输出 字典 集合 中 的 数据 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 一 个 DataManage 类 。 


public class DataManage 
{ 


和, 
步骤 3: 在 类 中 定义 一 个 私有 字段 ,用 于 存放 数据 。 


public class DataManage 
{ 


IDictionary< int, string>_dicData; 


} 
步骤 4: 定义 构造 函数 ,并 用 一 个 委托 作为 参数 ,委托 执行 后 会 返回 一 个 字典 集合 实例 。 
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public class DataManage 


{ 


IDictionary< int, string> dicData; 


public DataManage(Func < IDictionary < int, string>> data) 
{ 
_dicData = data(); 
} 
} 


步骤 5: 定义 一 个 公共 方法 ,将 字典 集合 中 的 数据 输出 到 屏幕 。 


public void DisplayDatal ) 
Console.WriteLine(" ---- 数据 列表 ----"); 
foreach(var kp in _dicData) 
不 
Console. WriteLine ( $"{kp. Key,4}\t{kp. Value}"); 
} 
} 


格式 化 字符 串 中 的 “,4” 表 示 输 出 的 文本 为 右 对 齐 ,长 度 为 4 个 字符 。 
步骤 6: 在 Main 方法 中 实例 化 DataManage 对 象 ,并 通过 构造 函数 传递 初始 数据 。 


DataManage dm = new DataManage(() = > new Dictionary< int, string> 
{ 


[1] = "window", 
[2] = "house", 
[Bl = "kite’s 
[4] = "noodles", 
[5] = "claim" 


和 
步骤 7: 调用 DisplayData 方法 ,输出 字典 集合 中 的 数据 。 


dm. DisplayData( ); 


步骤 8: 运行 应 用 程序 项 目 ,输出 内 容 如 图 4-13 所 示 。 图 4-13 输出 字典 数据 
4.3 继承 与 多 态 
实例 75 调用 基 类 的 构造 函数 


【导语 】 

base 关键 字 可 以 访问 基 类 实例 的 成 员 , 例 如 构造 函数 .属性 、 方 法、 事件 等 ; 相对 的 ,this 
关键 字 代 表 的 是 当前 类 型 的 实例 。 只 能 在 当前 类 的 构造 函数 进入 代码 块 之 前 访问 基 类 的 构 
造 函 数 ,在 当前 类 的 其 他 地 方 不 能 访问 。 
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【操作 流程 】 


步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
-个 带 两 个 参数 的 构造 函数 ,随后 通过 两 个 公共 属性 公开 两 个 


步骤 2: 声明 A 类 ,定义 
参数 的 值 。 


class 有 


{ 


public A(int v1, int v2) 


{ 
Valuel = v1; 
Value2 = v2; 
} 


public int Valuel { get; } 
public int Value2 { get; } 


} 


步骤 3: 声明 BB 类 ,从 A 类 派生 。 在 B 类 的 构造 函数 执行 之 前 ,调用 A 类 的 构造 函数 


classB:A 
{ 
public B() 
:base(900, 750) 
{ 


} 


在 base 关键 字 之 前 ,需要 添加 一 个 英文 的 冒号 ,表示 先 执行 A 类 的 构造 函数 ,然后 再 


执行 B 类 的 构造 函数 。 


步骤 4: 实例 化 B 类 的 对 象 , 并 输出 Valuel 和 Value2 属性 的 值 。 


Bv = new B(); 


Console. WriteLine( $ "Value 1 = {v.Valuel}"); 
Console. WriteLine( $ "Value 2 = A 


B 类 的 Valuel 和 Value2 


{v. Value2} 


属性 是 从 A 类 继承 的 。 


步骤 5: 按 下 F5 快捷 键 ,应 用 程序 将 输出 以 下 结果 。 


Value 1 = 900 
Value2 = 750 


实例 76 重 写 基 类 的 成 员 


【导语 】 


重 写 基 类 的 成 员 , 应 当 在 成 员 签名 上 加 override 关键 字 。 在 派生 类 中 对 


EE 写 基 类 的 成 员 ， 
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可 以 对 基 类 的 功能 进行 扩展 ,而 且 还 可 以 使 用 base 关键 字 来 访问 当前 成 员 的 基 类 版 本 。 
在 基 类 中 ,如果 和 希望 派生 类 能 够 重 写 某 个 成 员 ,应 该 在 成 员 签名 上 加 virtual 关键 字 ,将 
此 成 员 “ 虚 化 ”。 带 virtual 关键 字 的 成 员 既 可 以 包含 也 可 以 不 包含 实现 代码 。 
例如 以 下 两 种 形式 。 


// 基 类 

public virtual int GetIten ( string key ) 

// 派生 类 重 写 

public override int GetIten ( string key ) 

基 类 的 成 员 除了 可 以 使 用 virtual 关键 字 外 ,还 可 以 用 abstract 关键 字 , 这 会 使 成 员 * 抽 
象 化 "。 抽 象 成 员 与 虚 成 员 不 同 , 虚 化 的 成 员 可 以 包含 也 可 以 不 包含 具体 的 实现 代码 ,而 抽 
象 成 员 是 不 能 包含 实现 代码 的 。 因 此 派生 类 必须 重 写 抽象 成 员 ,但 不 一 定 要 重 写 虚 成 员 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 MyBase 类 作为 基 类 ,并 定义 一 个 虚 方 法 。 

class MyBase 


{ 


public virtual void Output() 
{ 
Console. WriteLine(" 基 类 的 方法 被 调用 ."); 
i 
} 


步骤 3: 定义 MyTest 类 ,从 MyBase 类 派生 ,并 且 重 写 基 类 的 方法 。 


class MyTest : MyBase 
{ 
public override void Output() 
{ 
Console. WriteLine(" 派 生 类 的 方法 被 调用 。"); 
base. Output(); 


} 
通过 base 关键 字 , 可 以 调用 基 类 的 成 员 。 在 上 面 代码 中 , 先 执行 派生 类 的 代码 ,然后 再 
调用 基 类 的 方法 。 


步骤 4: 以 下 代码 可 以 测试 成 员 的 重 写 。 


MyTest t = new MyTest(); 
t. Output( ); 


实例 77 彻底 替换 基 类 的 成 员 


【导语 】 
重 写 基 类 的 成 员 是 对 基 类 成 员 的 扩展 。 但 有 时 需要 彻底 蔡 换 基 类 的 成 员 , 即 虽然 成 员 
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的 名 称 与 基 类 的 成 员 相 同 ,但 功能 完全 不 同 。 
替换 基 类 成 员 ,应 当 在 成 员 签名 上 加 上 new 关键 字 ,格式 如 下 。 


// 基 类 
public void Work () 


// 派生 类 替换 
public new void Work() 


替换 成 员 一 般 应 用 于 : 派生 类 的 成 员 名 称 , 参 数 、 返 回 值 类 型 与 基 类 的 相同 ,但 是 在 功 
能 上 是 完全 不 同 的 情形 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 一 个 CheckTask 类 ,公开 一 个 Run 方法 。 


class CheckTask 
public void Run( int max) 

Console. WriteLine(" 最 大 执行 任务 数 :{0}。"，max) 
) } 


步骤 3: 定义 DRCheckTask 类 , 它 从 CheckTask 类 派生 。 


class DRCheckTask : CheckTask 
{ 
public new void Run( int count) 
{ 
Console. WriteLine(" 并 行 任务 数 :{0}。"，count); 


} 

} 

在 DRCheckTask 类 中 也 有 一 个 Run 方法 ,并 且 参 数 与 基 类 的 Run 方法 相同 (都 是 int 
类 型 ) ,可 是 它们 所 代表 的 含义 (功能 ) 不 同 。 基 类 中 Run 方法 的 参数 表示 可 以 执行 的 最 大 
任务 数 ,而 DRCheckTask 类 的 Run 方法 中 参数 表示 要 并 行 的 任务 数 。 由 于 功能 完全 不 同 ， 
所 以 派生 类 中 应 该 用 new 关键 字 完 全 替换 基 类 的 Run 方法 。 

步骤 4: 分 别 实 例 化 CheckTask 类 和 DRCheckTask 类 ,并 分 别 调用 它们 的 Run 方法 。 


CheckTask tl = new CheckTask(); 
t1. Run(15); 


Cprog.. — 0O x 


DRCheckTask t2 = new DRCheckTask( ); 
t2. Run(10); 


a ee ee ea 加 图 4-14 两 个 版 本 的 Run 
步骤 5: 运行 应 用 项 目 , 输 出 的 内 容 如 图 4-14 所 示 。 方法 的 输出 信息 
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实例 78 实现 多 个 接口 

【导语 】 

虽然 派生 类 不 能 同时 继承 多 个 类 ,但 可 以 同时 实现 多 个 接口 ， 
【操作 流程 ] 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 两 个 接口 ,各 包含 一 个 方法 。 


interface IRunnerl 
{ 
void StartWork(); 


} 


interface IRunner2 
{ 

void EndWork( ); 
} 


步骤 3: 声明 一 个 测试 类 ,该 类 可 以 同时 实现 以 上 两 个 接口 。 


class OneWork : IRunnerl, IRunner2 
{ 
public void EndWork( ) 
{ 
Console. WriteLine(" 结 束 操作 。"); 
} 


public void StartWork( ) 
{ 
Console. WriteLine(" 开 始 操作 。"); 
} 
} 


IRunnerl 接口 包含 StartWork 方法 ,IRunner2 接口 包含 EndWork 方法 。OneWork 类 
同时 实现 这 两 个 接口 ,因此 该 类 包含 StartWork 和 EndWork 两 个 方法 。 

步骤 4: 下 面 代 码 对 OneWork 类 进行 测试 调用 。 

OneWork ow = new OneWork(); 


ow. StartWork( ) ; 
ow. EndWork( ); 


注意 : 类 所 实现 的 接口 成 员 都 应 该 是 公共 成 员 , 因 为 接口 的 用 途 就 是 作为 一 种 规范 ,用 以 确 
定 面向 对 象 编程 的 基本 模型 。 接 口 一 般 要 提供 给 外 部 进行 代码 调用 (实现 接口 的 类 
可 以 对 外 部 隐藏 ), 只 有 公共 成 员 才 能 被 外 部 代码 访问 。 
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实例 79 实现 接口 的 结构 


【导语 】 

结构 类 型 虽然 不 能 继承 ,但 结构 是 可 以 实现 接口 的 。 
【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 接口 类 型 ,其 中 包含 一 个 方法 。 


interface ITest 
{ 

int Add(int a, int b); 
} 


步骤 3: 声明 一 个 实现 ITest 接口 的 结构 。 


struct TestCal : ITest 
{ 
public int add(int a, int b) 
{ 
returna + b; 
} 
} 


注意 : 结构 实现 接口 的 成 员 , 要 求 是 公共 成 员 。 
步骤 4: 在 Main 方法 中 编写 以 下 测试 代码 。 


ITest v = new TestCal(); 
int result = v.AMdd(10, 5); 
Console. WriteLine( "计算 结果 :{0}"，result); 


步骤 5: 运行 应 用 程序 项 目 , 屏 幕 输出 的 结果 如 下 。 


计算 结果 :15 
实例 80 ”隐藏 构造 函数 
【导语 】 


把 构造 函数 声明 为 私有 成 员 , 无 法 从 类 的 外 部 访问 构造 函数 ,就 不 能 用 new 运算 符 来 
实例 化 对 象 了 ,于 是 就 达到 了 隐藏 构造 函数 的 目的 。 

隐藏 构造 函数 通常 用 于 特殊 用 途 的 类 型 ,例如 一 些 访问 某 个 硬件 设备 的 类 ,一 般 不 希望 
在 应 用 程序 生命 周期 内 创建 过 多 的 实例 ,因为 多 个 实例 同时 操作 一 个 设备 容易 产生 冲突 。 
所 以 隐藏 了 构造 函数 的 类 需要 对 外 公开 一 个 静态 成 员 ( 例 如 静态 属性 ) ,使 得 外 部 代码 能 够 
访问 到 类 型 实例 。 


第 4 章 ”面向 对 象 编程 | 其 107 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 Camara 类 ,模拟 相机 设备 。 


class Canara 
{ 


private Guid _deviceID; 


private Camara() 
{ 

_deviceID = Guid. NewGuid(); 
} 


public Guid DeviceID => deviceID; 
} 
私有 字段 _deviceID 表示 设备 的 标识 ,并 由 DeviceID 属性 公开 。 构 造 函 数 加 了 private 
修饰 ,表明 该 构造 函数 无 法 被 外 部 访问 。 
步骤 3: 为 了 让 其 他 代码 能 够 访问 到 Camara 实例 ,需要 为 Camara 类 定义 一 个 静态 的 
公共 属性 ,以 获取 实例 引用 。 


private static Camara _currentInstance = new Camara(); 
public static Camara CurrentInstance => _currentInstance; 


步骤 4: 使 用 时 ,直接 通过 静态 属性 来 获取 Camara 类 的 实例 。 


Camara c = Camara. CurrentInstance; 
Console. WriteLine( $ "设备 标识 :{c.DeviceID}"); 


步骤 5: 运行 应 用 项 目 , 得 到 的 输出 内 容 如 下 。 


设备 标识 :1ca3f63e- 8513 - 497a- aa5d- 7749a061e6c5 


实例 81 到底 调用 了 谁 


【导语 】 

抽象 类 一 般 可 以 作为 一 组 相关 类 型 的 公共 基 类 ,不 能 实例 化 , 它 仅 仅 为 后 续 继 承 的 类 型 
提供 了 一 个 规范 。 抽 象 类 的 作用 与 接口 类 似 , 但 也 有 不 同 。 接 口 不 能 包含 任何 实现 代码 ,而 
且 接 口中 所 有 成 员 都 要 定义 为 公共 成 员 ; 抽象 类 中 既 可 以 包含 没有 实现 代码 的 抽象 成 员 ， 
也 可 以 包含 实现 的 类 型 成 员 。 继 承 抽 象 类 的 派生 类 必须 实现 其 抽象 成 员 。 


注意 : 抽象 类 中 可 以 包含 非 抽 象 成 员 , 但 非 抽 象 类 中 是 不 能 包含 抽象 成 员 的 。 因 为 非 抽 象 
类 可 以 实例 化 ,并 且 抽 象 成 员 没 有 任何 实现 代码 , 即 通过 非 抽象 类 实例 访问 抽象 成 员 
没有 实际 意义 。 
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当 从 抽象 类 派生 时 ,实现 抽象 成 员 的 方法 与 重 写 虚 成 员 相近 ,都 使 用 override 关键 字 。 
抽象 成 员 不 包含 任何 实现 代码 ,完全 交 由 派生 类 实现 。 当 通过 抽象 类 型 的 变量 去 调用 抽象 
成 员 时 ,应 用 程序 会 根据 赋值 给 变量 的 类 型 实例 来 决定 执行 哪些 代码 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 名 为 Animal 的 抽象 类 ,表示 某 种 动物 ,并 且 包 括 一 个 抽象 的 Name 属性 。 

abstract class Animal 

t 

public abstract string Name { get; } 

} 

从 Animal 派生 的 类 必须 实现 Name 属性 。 

步骤 3: 声明 三 个 类 ,都 实现 抽象 类 Animal( 即 从 Animal 类 派生 ) 。 


class Cat : Mnimal 


public override string Name => " 猫 猫 "; 


class Rabbit : Animal 
{ 
public override string Name => "兔子 "; 


class Dog : Animal 
{ 
public override string Name =>" 狗 狗 "; 


每 个 派生 类 都 可 以 根据 具体 的 情况 ,为 Name 属性 返回 不 同 的 值 。 
步骤 4: 在 Main 方法 中 ,声明 三 个 Animal 类 型 的 变量 ,并 分 别 为 每 个 变量 赋值 Cat、 
Rabbit 和 Dog 的 类 型 实例 。 


Animal al = new Cat(); 
Animal a2 = new Rabbit(); 
Animal a3 = new Dog(); 


步骤 5: 分 别 访问 它们 的 属性 。 


Console. WriteLine( $ "这 只 宠物 是 {al. Name}"); 
Console. WriteLine( $ "这 只 宠物 是 {a2. Name}"); 
Console. WriteLine( $ "这 只 宠物 是 {fa3.Namej"); 


步骤 6: 运行 应 用 程序 项 目 ,输出 结果 如 下 。 
这 只 宠物 是 猫 猎 
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这 只 宠物 是 兔子 

这 只 宠物 是 狗 狗 

当 访问 al 的 Name 属性 时 实际 上 是 访问 Cat 实例 的 Name 属性 , 同 理 , 在 访问 a2 变量 
时 实际 上 是 访问 Rabbit 实例 的 Name 属性 ,因此 调用 谁 的 Name 属性 取决 于 为 变量 所 赋 的 
具体 实例 。 

实例 82 ” 析 构 函数 

【导语 】 

析 构 函数 与 构造 函数 的 作用 正好 相反 。 构 造 函 数 在 创建 对 象 实例 时 调用 ,用 于 对 类 型 
成 员 初 始 化 ; 而 析 构 函数 则 是 在 对 象 实例 即将 被 回收 时 执行 ,可 用 于 一 些 清理 工作 。 

析 构 函数 都 以 "一 "开头 ,无 返回 值 无 参数 ， 一 "之 后 紧 跟 类 名 (无 空格 ) ,格式 如 下 。 


class Desk 


{ 
一 Desk() 


{ 


} 
} 


【操作 流程 】 
步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 用 于 测试 的 Example 类 ,并 且 定义 它 的 构造 函数 与 析 构 函数 。 


class Example 
{ 
public Example() 
{ 
WriteLine(" 构 造 函 数 被 调用 。"); 
i 


一 Example() 
{ 
WriteLine(" 析 构 函 数 被 调用 ."); 
} 
} 


步骤 3: 在 Program 类 中 声明 一 个 静态 方法 ,在 方法 中 声明 一 个 Example 类 的 变量 并 
进行 实例 化 。 


static void Test() 
{ 

Example ex = new Example(); 
} 
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由 于 变量 ex 是 在 方法 内 部 声明 的 ,其 生命 周期 在 执行 完 方法 后 就 会 结束 。 因 此 在 方法 
外 部 可 以 显 式 调 用 GC 的 相关 方法 进行 垃圾 回收 ,只 有 当 对 象 实例 被 回收 时 , 析 构 函数 才 会 


被 调用 。 


步骤 4: 在 Main 方法 中 调用 Test 方法 ,随后 立即 调用 GC 的 Collect 方法 进行 内 存 回 收 。 


Test(); 
// 进行 垃圾 回收 
CC. Collect(); 


实例 83 ”实现 IDisposable 接口 


【导语 】 


通过 实现 IDisposable 接口 进行 回收 清理 , 比 析 构 函数 更 易于 使 用 。 首先, 实现 
IDisposable 接口 后 ,类 型 会 公开 Dispose 方 法 ,可 以 在 代码 中 随时 调用 以 执行 清理 工作 ; 其 
次 ,实现 了 IDisposable 接口 的 类 型 可 用 于 using 语句 块 , 当 using 语句 块 代码 执行 完成 后 会 
自动 调用 Dispose 方法 来 清理 资源 。 

本 实例 实现 了 一 个 可 以 向 文本 文件 写 和 内容 的 类 。 类 中 包含 一 个 文件 流 实例 , 它 会 占 
用 文件 以 及 相关 的 内 存 资 源 , 在 类 的 构造 函数 中 初始 化 ,并 在 Dispose 方法 中 释放 文件 流 所 


占用 的 资源 。 
【操作 流程 】 


步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 ， 


步骤 2: 声明 TextWriter 类 ， 


见 代 码 清单 4-5。 


里 面包 装 了 一 个 文件 流 对 象 ,可 以 将 字符 串 写 人文 件 , 详 


代码 清单 4-5 ”TextWriter 类 完整 代码 


class TextWriter : IDisposable 
{ 
// 文件 名 
const string FILE NAME = 
// 文件 流 


FileStream fsWriter = null; 


public TextWriter() 
{ 
// 打开 或 创建 文件 


"demo. txt"; 


fsWriter = File.OpenWrite(FILE NAME); 


L 


public void WriteText(string str) 


{ 


// 获取 文本 的 字 节 数组 
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byte[ ] data = Encoding. UTF8. GetBytes( str); 
// 将 字 节 数组 写 人 文件 流 
fsWriter. Write(data, 0, data. Length) 
// 将 缓冲 的 数据 写 人 文件 
fsWriter. Flush( ); 
} 


public void Dispose() 


// 关闭 文件 流 
fsWriter?. Close(); 
// 释放 资源 


fsWriter?.Dispose(); 


} 


步骤 3: 使 用 TextWriter 时 ,可 以 将 其 实例 放 在 using 语句 块 中 ,当代 码 流程 执行 完 退 
出 using 语句 块 后 ,TextWriter 中 实现 的 Dispose 方法 就 会 被 调用 ,以 进行 资源 清理 工作 。 


using(TextWriter wt = new TextWriter()) 
[| 
她 .WriteText ("编程 真 快乐 。"); 

} 

调用 WriteText 方法 可 以 向 文件 写 人 文本 内 容 。 

步骤 4: 按 下 F5 快捷 键 运行 应 用 程序 , 待 程 序 退出 后 ,再 找到 项 目 路 径 下 的 \bin\ 
Debug\netcoreapp < 版 本 号 > 子 目录 ,会 看 到 一 个 名 为 demo. txt 的 文件 ,应 用 程序 所 写 入 的 
文本 内 容 就 存放 在 该 文件 中 。 

实例 84 显 式 实现 接口 

【导语 】 

显 式 实现 接口 就 是 在 实现 接口 的 成 员 前 面 加 上 接口 的 名 称 。 这 种 方法 可 以 有 效 解决 接 
口 成 员 冲 突 问题 。 例 如 ,IA 接口 中 包含 Play 方法 ,而 JB 接口 中 也 包含 Play 方法 , 若 使 用 常 
规 方式 同时 实现 这 两 个 接口 ,那么 类 型 中 只 能 有 一 个 Play 方法 。 例 如 下 述 代码 。 


interface IA{ 
void Play(); 
} 
interface IB { 
void Play(); 
} 
class Test : IA, IB 
{ 
public void Play() { } 
} 
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因为 两 个 接口 中 Play 方法 的 签名 相同 ,只 能 出 现 一 个 。 假 设 这 两 个 接口 中 的 Play 方 
法 签名 相同 ,但 是 所 代表 的 功能 和 含义 不 同 , 即 IA 接口 中 的 Play 方法 用 来 播放 音乐 ,而 人 B 
接口 中 的 Play 方法 用 来 开始 玩 游戏 。 要 同时 实现 这 两 个 Play 方法 ,就 要 让 它 显 式 地 实现 
两 个 接口 了 。 上 述 代 码 可 以 修改 为 以 下 形式 。 

class Test : IA, IB 

{ 

jo any 
void IB.Play() { } 

} 

显 式 实现 接口 后 ,无 法 通过 实现 类 的 变量 去 调用 Play 方法 ,必须 使 用 接口 来 声明 变量 
才能 访问 。 例 如 ,如 果 要 调用 IA 接口 的 Play 方法 ,就 要 用 IA 类 型 去 声明 变量 ,赋值 时 引用 
Test 类 的 实例 ,然后 再 通过 变量 调用 Play 方法 。 

IAv = new Test(); 

v.Play(); 


使 用 以 下 代码 是 无 法 访问 Play 方法 的 。 


Test x = new Test(); 

x. Play(); 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 两 个 接口 ,它们 都 包含 一 个 Start 方法 。 


interface IDownloader 
{ 
void Start(); 
} 
interface IUploader 
{ 
void Start(); 
} 


IDownloader 接口 模拟 一 个 从 网 络 下 载 数据 的 操作 ,IUploader 接口 则 模拟 一 个 向 网 络 
上 传 数据 的 操作 。 很 明显 ,两 个 Start 方法 尽管 签名 相同 但 功能 不 同 , 一 个 开启 下 载 操作 , 另 一 
个 开启 上 传 操作 ,因此 如 果 某 个 类 型 同时 实现 这 两 个 接口 ,就 必须 显 式 实现 两 个 Start 方法 。 

步骤 3: 声明 一 个 类 ,同时 实现 以 上 两 个 接口 ,此 处 必须 使 用 显 式 实现 接口 的 方式 ,否则 
无 法 同时 完成 两 个 Start 方法 的 实现 。 

class NetworkManager : IDownloader，IUploader 

{ 

void IDownloader. Start( ) 


下 
Console. WriteLine(" 正 在 下 载 ,请 稍 等 … …"); 
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} 


void IUploader. Start() 
{ 
Console. WriteLine(" 内 容 上 传 中 ,请 稍 等 … … 
} 
} 


步骤 4: 在 使 用 时 ,可 以 先 实例 化 NetworkManager 类 。 
NetworkManager mng = new NetworkManager(); 
步骤 5: 要 启动 下 载 或 上 传 操作 ,必须 通过 相应 的 接口 变量 来 调用 。 


// 要 下 载 ,只 能 通过 IDownloader 接口 类 型 的 变量 来 访问 
IDownloader dl = mng; 

dl. Start(); 

// 要 上 传 ,也 只 能 通过 IUploader 接口 类 型 的 变量 来 访问 
IUploader ul = mng; 

ul. Start(); 


因为 NetworkManager 类 同时 实现 了 这 两 个 接口 ,所 以 
NetworkManager 类 的 实例 可 以 赋值 给 使 用 接口 类 型 声明 的 变 


量 ,属于 隐 式 转换 。 图 4-15 调用 显 式 实现 
步骤 6: 运行 应 用 程序 项 目 , 会 看 到 如 图 4-15 所 示 的 输出 结果 。 接口 的 成 员 
实例 85 阻止 类 被 继承 
【导语 】 


出 于 对 象 模型 的 实际 需要 ,有 时 需要 禁止 某 个 类 被 继承 ,即使 其 成 为 密封 类 。 以 下 实例 
简单 演示 了 使 用 sealed 关键 字 声 明 密封 类 的 方法 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 Pear 类 ,并 加 上 sealed 关键 字 ( 在 class 关键 字 之 前 ) 。 


sealed class Pear 


{ 
} 
步骤 3: 尝试 从 Pear 类 派生 出 WildPear 类 。 


class WildPear : Pear 


{ 
} 
此 时 会 提示 错误 ,因为 Pear 类 已 经 是 密封 类 ,无 法 被 继承 。 
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实例 86” 谋 套 类 

【导语 】 

所 谓 嵌 套 类 ,就 是 在 类 中 又 声明 一 个 类 。 髓 套 类 之 间 虽 然 产 生 了 层级 关系 ,但 每 个 类 都 
是 独立 的 ,也 就 是 说 ,一 个 类 的 内 部 是 不 能 访问 其 骨 套 类 的 。 如 果 要 访问 ,只 能 通过 变量 来 
传递 。 例如 ,A 类 中 嵌 套 了 B 类 ,在 A 类 内 部 想 访问 B 类 实例 时 ,可 以 先 在 A 类 中 声明 一 
个 B 类 的 私有 字段 并 引用 有 效 的 B 类 实例 ,再 通过 这 个 私有 字段 访问 B 类 的 某 个 实例 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 公共 类 ,类 中 包含 一 个 公共 方法 以 及 一 个 嵌 套 类 。 


public class TheOut 

{ 
// 公开 一 个 属性 用 于 设置 TheNest 实例 , 以 便 在 类 中 访问 TheNest 实例 
public TheNest Nest0bj { get; set; } 


public void CallNest() 


NestObj?.CallMe(); 
} 


public class TheNest 
{ 
public void CallMe() => WriteLine(" 正 在 访问 柑 套 的 类 实例 ."); 
} 
} 


尽管 TheNest 类 包含 在 TheOut 类 中 ,然而 它们 被 视 为 独立 的 类 , 即 类 名 分 别 为 
TheOut 与 TheOut. TheNest。 为 了 让 TheOut 类 中 的 代码 能 访问 TheNest 实例 ,本 实例 的 
处 理 方法 是 在 TheOut 类 中 公开 一 个 NestObj 属性 ,该 属性 可 以 设置 对 TheNest 类 实例 的 
引用 ,这 样 在 TheOut 类 的 CallNest 方法 中 就 可 以 使 用 TheNest 实例 了 。 

步骤 3: 对 嵌 套 类 的 使 用 进行 测试 。 分 别 创建 两 个 类 的 实例 ,然后 把 TheNest 类 的 实 
例 赋值 给 NestObj 属性 。 

TheOut objl = new TheOut(); 


TheOut. TheNest obj2 = new TheOut. TheNest(); 
obj1. NestObj = obj2; 


步骤 4: 然后 就 能 访问 和 嵌 套 类 中 的 CallMe 方法 了 。 


obj1.CallNest(); 


注意 : 访问 谋 套 类 的 类 名 时 ,需要 加 上 它 的 父 级 类 的 类 名 。 例 如 本 实例 中 ,在 声明 obj2 变 
量 时 ,类 名 要 写成 TheOut. TheNest, 中 间 使 用 成 员 运 算 符 ( 半 和 角 和 句号) 连接 。 


实例 87 ”匿名 类 型 
【导语 】 


类 型 名 称 由 编译 器 自动 分 配 。 因 此 开发 者 


接 访 问 类 型 信息 。 


后 面 紧 跟 对 象 初始 化 代码 ( 写 在 一 对 大 括号 中 )。 例 


> 并 使 用 new 运算 符 初始 化 。 


Var X = Dew 

City = "天 津 "， 

Phone = "13477689366" 
}; 
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匿名 类 型 是 一 种 比较 方便 实用 的 轻型 对 象 模型 。 使 用 之 前 无 须 在 代码 中 声明 新 的 类 ， 
有 先 不 会 知道 匿名 类 型 的 名 称 ,无 法 在 代码 中 直 


正 是 由 于 匿名 类 型 的 类 型 名 称 无 法 预先 知晓 ,所 以 在 声明 匿名 类 型 的 变量 时 只 能 使 用 


var 关键 字 , 让 编译 自动 推测 变量 的 类 型 。 初 始 化 匿名 类 型 实例 时 依然 使 用 new 运算 符 。 


如 ,下 面 代码 声明 一 个 匿名 类 型 的 变量 


只 能 分 配 公共 的 只 读 属性 给 匿名 对 象 ,因此 必须 在 初始 化 时 赋值 属性 。 匿 名 对 象 初始 


化 后 ,属性 都 是 只 读 的 ,无 法 在 代码 中 修改 。 
【操作 流程 】 
步骤 1: 新建 控制 台 应 用 程序 项 目 。 


步骤 2: 在 项 目 模板 生成 的 Main 方法 中 声明 


var d = new 

{ 
Color = "白色 "， 
Size = 43.6f, 
Number = 7988 


}; 


-个 变量 ,并 且 使 用 匿名 对 象 进行 赋值 。 


给 属性 赋值 的 时 候 ,直接 写 上 属性 的 名 称 赋值 即 可 ,编译 器 会 自动 推测 属性 的 类 型 。 


步骤 3: 输出 匿名 对 象 的 各 个 属性 的 值 。 


string str = $" 颜 色 : {d. Color}j\n 尺码 : {d. Size} \n 编号 : 


{d. Nomber}"; 


Console. WriteLine(" 商 品 信息 :\n{0}",，str); 


步骤 4: 按 下 F5 快捷 键 ,运行 项 目 , 屏 幕 输出 结果 如 图 4-16 


所 示 。 


图 4-16 输出 匿名 对 
象 的 属性 值 
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4.4 枚 举 


实例 88 ”声明 枚 举 类 型 


【导语 】 

枚 举 类 型 由 一 组 常量 值 组 成 ,而 且 这 些 常量 是 可 以 命名 的 。 在 向 变量 赋值 时 ,必须 从 枚 
举 类 型 所 定义 的 值 中 选择 一 项 。 例 如 ,一 个 枚 举 可 以 表示 电源 开关 的 状态 ,假设 On 表示 开 
关 处 于 “打开 ”状态 ,并 分 配 整数 值 1; Off 表示 “关闭 ”状态 ,分 配 整 数值 0。 当 要 对 电源 开关 
的 状态 进行 更 新 时 ,只 能 选择 On 或 者 Off, 不 会 出 现 其 他 的 值 。 因 此 , 枚 举 类 型 也 能 起 到 一 
种 规范 选项 的 作用 。 枚 举 中 各 个 常量 值 都 是 整数 值 (如 byte、int、long、uint 等 ), 所 以 枚 举 
属于 值 类 型 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 枚 举 类 型 .并 分 配 三 个 值 。 


enum Options 


{ 


Oneay = 1, 
TwoWay = 2, 
MixWay = 3 


} 


声明 枚 举 类 型 需要 使 用 enum 关键 字 。 其 中 ,OneWay、TwoWay、MixWay 是 常量 的 名 
称 ,1、2、3 是 常量 的 值 。 为 常量 分 配 一 个 有 意义 的 名 字 , 可 以 方便 识别 和 记忆 。 
步骤 3: 在 Main 方法 中 用 上 面 定义 的 枚 举 类 型 声明 三 个 变量 ,并 分 别 赋 不 同 的 常量 


Options a = Options. OneWay; 


Options b - Options. TwoWay; 

Options c = 

在 给 枚 举 变量 赋值 时 ,直接 访问 枚 举 类 型 的 常量 名 即 可 。 

步骤 4: 将 三 个 变量 所 使 用 的 枚 举 常量 名 与 常量 值 分 别 输出 到 屏幕 。 

WriteLine( $ "常量 名 :{aj, 常 量 值 :{(int)alj")， 

WriteLine( $ "常量 名 :{b}, 常 量 值 :{ (int)b}"); 

WriteLine( $ "常量 名 :{c} ,常量 值 :{ (int)c}"); 

因为 枚 举 的 常量 值 是 整数 值 ,并 且 默 认 使 用 int 类 型 的 
值 ,因此 要 获取 某 个 常量 的 值 ,可 以 直接 将 它 转 换 为 int 类 
型 的 值 图 4-17 输出 枚 举 的 常量 


eo 全 名 称 与 常量 值 
步骤 5: 运行 应 用 程序 项 目 ,输出 内 容 如 图 4-17 所 示 。 


Options. MixWay; 


C\Program Fi 一 口 x 
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实例 89 指定 枚 举 的 基础 类 型 


【导语 】 
在 声明 枚 举 类 型 时 ,如 果 不 指 定 其 基础 类 型 , 则 其 常量 值 默认 为 int 类 型 。 在 有 特殊 需 
要 的 情况 下 ,可 以 明确 指定 枚 举 中 常量 值 的 基础 类 型 。 必 须 使 用 整数 值 的 基础 类 型 ,例如 
int、byte ,uint、long、ulong 等 ,不 能 使 用 非 整数 类 型 ,例如 double。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 枚 举 类 型 ,指定 其 常量 值 基于 byte 类 型 。 
bublic enum Readyode : byte 
{ 
NewFile = 1, 
OpenCurrent = 2, 


Saved = 3 


} 
步骤 3: 青 声 明 一 个 枚 举 类 型 ,常量 类 型 为 uint。 


public enum PictureQt : uint 


二 
= 12, 
MO = 7 


注意 : 指定 枚 举 常 量 的 基础 类 型 使 用 半角 冒号 来 表示 ,与 类 之 间 的 继承 相似 。 


实例 90 常量 的 标志 位 运算 
【导语 】 
因为 枚 举 类 型 的 基础 类 型 是 整数 类 型 ,因此 , 枚 举 的 常量 值 之 间 也 可 以 进行 位 运算 。 即 
按 位 “与 And) 、 按 位 “或 "Or) ,以 及 取 反 (Not)、 异 或 (Xor) 等 。 
支持 按 位 运算 的 枚 举 类 型 在 声明 时 需要 应 用 FlagsAttribute, 例 如 以 下 形式 。 
[FlagsAttribute] 
enum MultiHue : short 
{ 
None = 0, 
Black = 1, 
Bed = 2, 
Green = 4, 
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Blue = 8 

1 

如 果 和 希望 枚 举 类 型 的 值 支持 位 运算 ,不 仅 要 在 类 型 定义 时 使 用 FlagsAttribute, 还 必须 
注意 每 个 常量 值 的 合理 安排 。 一 般 来 说 ,常量 值 是 以 2 为 底数 的 寡 运 算 结 果 。 例 如 1、2、4、 
8、16、32 等 。 每 个 常量 值 只 有 作为 标志 的 二 进 制 位 才 为 1, 其 他 位 均 为 0。 

例如 上 面 举例 的 MultiHue 枚 举 , None 的 常量 值 为 0, 转 换 为 二 进 制 为 0000; Black 的 
常量 值 转换 为 二 进 制 为 0001; Red 的 常量 值 转换 为 二 进 制 为 0010; Green 的 常量 值 转换 为 
二 进 制 为 0100; Blue 的 常量 值 转换 为 二 进 制 为 1000。 

如 果 将 Black 和 Red 两 个 值 组 合 ,得 到 的 结果 为 0011, 如 果 将 Green 和 Blue 两 个 值 进 
行 组 合 , 得 到 的 结果 为 1100。 如 果 将 MultiHue 枚 举 的 所 有 值 都 进行 组 合 ,得 到 的 结果 
洲 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 枚 举 类 型 ,并 且 应 用 FlagsAttribute, 使 其 支持 按 位 运算 。 


[Flags] 
enum TrackItem 


{ 


Trackl = 1, 
Track2 = 2, 
Track3 = 4, 
Track4 = 8, 
Track5 = 16 


注意 ; 虽然 在 不 应 用 FlagsAttribute 的 情况 下 , 枚 举 的 常量 值 仍 然 能 够 进行 按 位 运算 ,但 是 
当 调 用 枚 举 实例 的 ToString 方法 时 ,是 无 法 正确 返回 常量 值 的 名 称 的 。 如 果 应 用 了 
FlagsAttribute, 调 用 ToString 方法 可 以 得 到 已 经 组 合 的 常量 名 称 列表 ,并 且 以 半角 
过 号 隔 开 。 

步骤 3: 在 项 目 模板 生成 的 Program 类 中 声明 一 个 静态 方法 ,用 于 在 屏幕 上 输出 经 过 

组 合 运 算 后 的 枚 举 实例 的 常量 名 称 以 及 常量 的 二 进 制 值 。 


static void OutputInfo(TrackItem t) 
t 


string pl = t.ToString(); 
string p2 = Convert.ToString((int)t, 2).PadLeft(5, '0'); 
Console. WriteLine( $ "{p2, - 4} —— {p1}"); 


$ 
步骤 4: 在 Main 方法 中 ,声明 几 个 枚 举 变量 ,并 赋予 经 过 组 合 后 的 枚 举 值 ,然后 调用 
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OutputInfo 方法 进行 测试 。 


// 将 Trackl 与 Track2 组 合 

TrackItem tl = TrackItem. Trackl | TrackItem. Track2; 

QutputInfo(t1); 

// 将 Track3、Track4、Track5 进行 组 合 

TrackIten t2 = TrackItem. Track3 | TrackItem. Track4 | TrackItem. Track5; 

OutputInfo(t2); 

// 将 枚 举 中 所 有 值 都 进行 组 合 

TrackItem t3 = TrackItem. Trackl | TrackItem. Track2 | TrackItem. Track3 | TrackItem. Track4 | 
TrackItem. Track5; 

QutputInfo(t3); 


步骤 5: 运行 应 用 程序 项 目 ,输出 结果 如 图 4-18 所 示 。 


图 4-18 输出 按 位 运算 后 的 枚 举 值 


步骤 6: 在 声明 枚 举 类 型 的 时 候 ,是 允许 使 用 表达 式 的 计算 结果 来 给 常量 赋值 的 。 可 以 
在 上 面 声明 的 TrackItem 枚 举 中 添加 一 个 AllTracks 常量 ,然后 它 的 值 就 是 前 面 5 个 常量 
值 的 组 合 。 


Flags] 
enum TrackItem 


1 


Trackl = 1, 
Track2 = 2, 
Track3 = 4, 
Track4 = 8, 
Track5 = 16, 


AllTracks = Trackl | Track2 | Track3 | Track4 | Track5 


实例 91 自动 产生 的 常量 值 


【导语 】 
如 果 在 一 个 枚 举 类 型 中 ,没有 为 任何 常量 明确 赋值 ,就 像 这 样 : 


enum Type 
{ 

Run, Stop, Close 
} 
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这 种 情况 下 常量 会 自动 产生 从 0 开始 ,并 按 顺 序 排列 的 整数 值 。 例 如 ,上 面 的 Type 枚 举 ， 
Run 常量 的 值 为 0,Stop 常量 的 值 为 1,Close 常量 的 值 为 2。 
如 果 遇 到 明确 赋值 的 常量 ,而 其 后 的 常量 未 明确 赋值 的 情况 ,例如 : 


enum Test 

{ 
Toy, 
Se 
Ship, 
Fox 

} 


其 中 ,Toy 常量 没有 明确 赋值 ,所 以 默认 为 0。Pie 明确 赋值 为 5, 而 且 Pie 之 后 的 常量 都 没 
有 明确 赋值 ,因此 以 Pie 常量 的 5 为 基础 自动 生成 整数 值 , 即 Ship 常量 的 值 为 6,Fox 常量 
的 值 为 7。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 枚 举 类 型 。 


enum Examnple 

{ 
ItemA = 3, 
ItemB, 
ItemC = 10, 
ItemD, 
ItemE 

} 


ItemA 明确 赋值 为 3, 因 此 ItemB 自动 分 配 值 4,ItemC 赋值 为 10, 于 是 ItemD 自动 分 
配 值 11 ,ItemE 自动 分 配 值 12。 
步骤 3: 声明 Example 枚 举 的 变量 并 进行 赋值 ,然后 输出 常量 对 应 的 整数 值 。 


Example y = Example. ItemA; 
WriteLine( $"{y} = {(int)y}"); 
Y = Exanple, ItemB; 

WriteLine( $"{y} = {(int)y}"); 
y = Exanple. ItemD; 

WriteLine( $"{y} = {(int)y}"); 


步骤 4: 按 F5 快捷 键 运行 应 用 程序 项 目 ,结果 如 图 4-19 图 4-19 输出 枚 举 中 自动 
所 示 。 产生 的 常量 值 
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实例 92 获取 枚 举 中 常量 的 名 称 


【导语 】 

在 . NET 类 库 中 有 一 个 Enum 类 , 它 是 枚 举 类 型 的 隐 式 基 类 。 在 代码 中 声明 枚 举 类 型 
时 无 须要 继承 Enum 类 。Enum 类 提供 一 系列 方法 (包括 实例 方法 和 静态 方法 ) ,可 以 对 枚 
举 类 型 进行 各 种 处 理 。 例 如 ,本 实例 需要 获取 枚 举 类 型 中 常量 的 名 称 , 对 应 地 ,在 Enum 类 
中 有 两 个 静态 方法 可 以 完成 此 功能 。 

其 中 ,GetName 方法 只 能 获取 枚 举 类 型 中 单个 常量 的 名 称 , 因 此 调用 该 方法 时 需要 提 
供 一 个 具体 的 常量 ; 而 GetNames 方法 可 以 获取 枚 举 类 型 中 所 有 已 定义 常量 的 名 称 , 以 字 
符 串 数组 的 形式 返回 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 System 命名 空间 下 有 一 个 DayOfWeek 枚 举 , 它 定义 了 一 周 七 天 的 名 称 ( 从 
星期 天 到 星期 六 )。 可 以 使 用 Enum 类 的 GetNames 方法 获取 DayOfWeek 枚 举 中 所 有 常量 
的 名 称 。 


string[ ] days = Enum. GetNames(typeof(DayOfWeek)); 


步骤 3: 使 用 foreach 循环 把 字符 串 数 组 中 的 元 素 输出 到 屏 
幕 上 。 


foreach(string d in days) 
{ 


Console. WriteLine(d); 图 4-20 DayOfWeek 
} 枚 举 中 的 常 
步骤 4: 运行 应 用 程序 项 目 ,屏幕 输 出 结果 如 图 4-20 所 示 。 量 名 称 列表 
实例 93 检查 枚 举 实例 中 是 否 包 含 某 个 标志 位 
【导语 】 


枚 举 类 型 的 常量 值 可 以 组 合 起 来 使 用 ,在 实际 开发 中 ,经 常 需要 检查 枚 举 实例 中 是 否 包 
含 指定 的 标志 位 。 例 如 , 枚 举 类 型 Demo 中 定义 了 三 个 常量 ,分 别 命名 为 A、B、C, 假 设 声 明 
了 一 个 变量 k, 并 在 赋值 时 将 A 和 也 组 合 。 


Demo k = Denmo.A | Demo.B; 

在 代码 中 有 两 种 方法 可 以 检查 变量 k 的 值 中 有 没有 包含 A。 一 种 方法 就 是 把 变量 k 与 
Demo. A 的 值 进行 按 位 与” 运算。 由 于 “与 ”运算 时 只 有 两 个 标志 位 同时 为 1 时 才能 得 到 结 
果 1, 因 此 ,把 变量 k 与 Demo. A 进行 按 位 “与 ”运算 后 ,如 果 变 量 k 中 包含 A 的 标志 位 , 那 
么 运算 的 结果 就 是 Demo. A, 因 为 其 他 标志 位 在 运算 后 都 为 0; 如 果 变量 k 中 没有 A 的 标 
志 位 ,那么 跟 Demo. A 进行 按 位 “与 ”运算 后 的 结果 就 是 0。 还 有 一 种 方法 ,可 以 调用 枚 举 类 
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型 实 


例 的 HasFlag 方法 ,通过 参数 传递 要 被 检查 的 常量 值 ,如 果 变 量 中 包含 指定 的 标志 位 ， 


HasFlag 方法 返回 true, 否则 返回 false。 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 枚 举 类 型 Test, 并 在 其 上 面 应 用 FlagsAttribute, 表 示 它 支持 组 合 


使 用 。 


[Flags] 
enum Test 
{ 
Model, Mode2, Mode3 
} 


步骤 3: 声明 一 个 枚 举 类 型 的 变量 ,并 将 Mode2 和 Mode3 两 个 常量 组 合 赋值 。 
Test 七 = Test. Mode2 | Test.Mode3; 


步骤 4: 使 用 HasFlag 方法 检查 变量 中 是 否 包含 Mode3 标志 位 。 


bool b = t+.HasFlag(Test. Mode3); 
步骤 5: 再 声明 一 个 变量 ,将 Model、Mode2、Mode3 三 个 常量 进行 组 合 。 
Test t2 = Test.Model | Test.Mode2 | Test. Mode3; 


步骤 6: 通过 按 位 “与 ”运算 来 检查 变量 中 是 否 包含 Model 标志 位 。 


bool b2 = (t2 & Test.Model) == Test.Model; 


4.5 特性 


信息 。 特 性 一 般 有 以 下 特征 。 


定 。 
面 ， 


实例 94 自 定义 特性 类 


【导语 】 
特性 是 一 种 比较 特殊 的 类 ,通常 作为 代码 对 象 的 附加 部 分 ,用 了 


下 


向 运行 时 提供 一 些 补充 


(1) 从 Attribute 类 派生 。 
(2) 类 型 名 称 一 般 以 Attribute 结尾 。 尽 管 这 不 是 语法 规则 ,但 开发 者 应 当 遵守 这 一 约 
使 用 以 Attribute 结尾 的 类 名 ,一 方面 便于 他 人 识别 (一 看 名 字 就 知道 是 特性 类 ); 另 一 方 
在 输入 代码 时 可 以 将 Attribute 后 缀 省 略 , 编 译 器 能 够 自动 识别 。 例 如 ， 


MTAThreadAttribute 类 是 一 个 特性 类 ,在 代码 中 可 以 直接 输入 MTAThread 。 


(3) 在 声明 特性 类 时 必须 在 类 上 应 用 AttributeUsageAttribute。AttributeUsageAttribute 


本 身 也 是 一 个 特性 类 ,用 于 标注 当前 声明 的 特性 类 应 用 于 哪些 对 象 。 例 如 ,该 特性 是 否 只 能 在 
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类 上 面 应 用 ,还 是 可 以 同时 在 类 、 属 性 和 方法 上 应 用 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 自 定义 的 特性 类 ,命名 为 MyDemoAttribute。 


[AttributeUsage(AttributeTargets. Property | AttributeTargets. Method) ] 
public class MyDemoAttribute : Attribute 
{ 

public string Description { get; set; } 


} 


通过 应 用 AttributeUsageAttribute, 指明 MyDemoAttribute 只 能 应 用 在 属性 和 方法 
上 面 。 
步骤 3: 声明 一 个 类 ,并 在 类 的 属性 和 方法 上 应 用 上 面 自 定 义 的 特性 。 


public class OrderData 
{ 


[MyDemo(Description = "订单 ID")] 
public int OrdID { get; set; } 


[MyDemo(Description = "添加 时 间 ")] 
public DateTine Addrime { get; set; } 


[MyDemo(Description = "计算 折扣 价 ")] 
public double Compute( double q) 
{ 
return q * 0.98d; 
} 
} 
Description 是 MyDemoAttribute 类 的 一 个 公共 属性 ,在 应 用 特性 时 .可 以 在 括号 中 为 
属性 赋值 。 


注意 : 不 要 把 特性 与 代码 注释 混 消 。 代 码 注 释 虽 然 也 起 着 附加 说 明 的 作用 ,但 是 不 参与 代 
码 编译 。 而 特性 是 一 种 类 , 它 本 身 是 参与 代码 编译 的 ,而 且 可 以 在 代码 中 访问 。 


实例 95 ”向 特性 类 的 构造 函数 传递 参数 


【导语 】 

特性 类 虽然 用 途 特殊 ,但 本 质 上 它 也 属于 类 ,因此 也 有 构造 函数 。 如 果 特 性 类 只 有 公共 
的 无 参数 构造 函数 ,那么 在 应 用 时 可 以 忽略 小 括号 ,在 中 括号 中 直接 输入 特性 类 的 名 称 即 
可 。 如 果 特 性 类 有 带 参数 的 构造 函数 ,那么 在 应 用 时 需要 写 上 一 对 小 括号 ,然后 在 小 括号 中 
填 上 参数 (与 普通 构造 函数 的 传 参 方法 一 致 ) 。 
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例如 ,有 一 个 特性 类 名 为 TestAttribute, 其 中 有 两 个 string 类 型 的 参数 。 在 应 用 该 特 
性 时 应 该 写 为 。 


[Test ( "abc", "def" )] 


如 果 特 性 不 仅 存 在 带 参 数 的 构造 函数 ,还 公开 了 属性 成 员 , 那 么 可 以 先 为 构造 函数 传递 
参数 ,然后 再 为 属性 赋值 。 
例如 , 某 个 特性 类 的 声明 如 下 。 


[attributeUsage(RttributeTargets.Class) ] 
class LimitedAttribute:Attribute 


{ 


int min, _nmax; 
public LimitedAttribute( int min, int max) 


_min = min; 


_max = max; 


public int BaseNum { get; set; } 
} 


在 应 用 该 特性 时 ,可 以 先 为 构造 函数 传递 两 个 int 值 ,然后 再 为 BaseNum 属性 赋值 。 


[Limited(4,6,BaseNum = 1)] 
public class Production 
{ 


} 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 自 定义 的 特性 类 。 该 特性 类 可 应 用 于 类 和 结构 ,并 且 带 有 一 个 double 
类 型 参数 的 公开 构造 函数 。 


[AttributeUsage(AttributeTargets. Class | AttributeTargets. Struct)] 
public class DoubleRangeAttribute : Attribute 


{ 
public double Largest { get; } 


public DoubleRangeAttribute( double largest) 


{ 
Largest = largest; 
} 
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步骤 3: 声明 一 个 类 ,并 且 应 用 上 面 定义 的 DoubleRangeAttribute。 


[DoubleRange( 700d) ] 
public class Test 
{ 


} 
实例 96 在 同一 对 象 上 应 用 多 个 特性 实例 
【导语 】 


在 声明 特性 类 时 ,应 用 的 AttributeUsageAttribute 特性 类 有 一 个 名 为 AllowMultiple 
的 属性 ,用 于 设置 所 声明 的 特性 类 是 否 允 许 在 同一 个 代码 对 象 上 应 用 多 个 特性 实例 。 该 属 
性 默认 为 false, 即 在 同一 个 代码 对 象 上 只 能 应 用 一 个 特性 实例 。 
例如 ,ObsoleteAttribute 类 没有 将 AllowMnultiple 属性 设置 为 true, 所 以 ,在 下 面 代 码 
中 会 出 现 错误 。 


[Obsolete] 
[Obsolete] 
class Docs 
{ 


} 

尝试 编译 以 上 Docs 类 会 出 现 “ 特 性 重复 ”的 错误 消息 ,因为 Docs 类 上 同时 应 用 了 两 个 
ObsoleteAttribute 。 

【操作 流程 】 

步骤 1: 新建 控 制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 自 定义 的 特性 类 。 


[AttributeUsage(AttributeTargets. Class, AllowMultiple = true)] 
public class CustomAttribute : Attribute 
{ 
public string Ver { get; set; } 
} 


为 了 使 该 特性 支持 多 实例 ,需要 将 AllowMultiple 属性 设置 为 true。 
步骤 3: 声明 一 个 普通 类 ,并 在 该 类 应 用 两 个 CustomAttribute 实例 。 
[Custom(Ver = "1.0.0.1"), Custom(Ver = "1.0.2.0")] 


public class AppData 
{ 


} 
如 果 AllowMaultiple 属性 的 值 改 为 false 或 保留 默认 值 ,以 上 代码 将 无 法 通过 编译 。 
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实例 97 在 运行 阶段 检索 特性 实例 


【导语 】 

特性 类 的 作用 是 为 代码 对 象 应 用 一 些 辅助 的 信息 ,因此 在 应 用 程序 运行 阶段 ,可 以 检索 
特性 类 实例 的 相关 数据 ,对 数据 进行 验证 。 

要 实现 在 运行 阶段 检索 特性 ,需要 用 到 反射 技术 , 即 在 运行 时 获取 类 型 以 及 其 成 员 相 关 
的 信息 ,然后 再 查找 出 已 应 用 特性 的 对 象 。 

通过 Type 类 可 以 得 到 各 种 代码 对 象 (类 方法、 属性 .字段 等 ) 的 信息 ,它们 的 共同 基 类 
是 MemberInfo ,通过 GetCustomAttribute 扩展 方法 (在 CustomAttributeExtensions 类 中 
定义 ) 可 以 直接 检索 到 已 应 用 的 特性 实例 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 特性 类 ,并 指定 它 只 能 应 用 于 属性 成 员 。 


[attributeUsage(RttributeTargets.Property) ] 
public class MyAttribute : Attribute 
{ 
public char StartChar { get; set; } 
public int MaxLen { get; set; } 
} 


StartChar 属性 用 于 指定 一 个 字符 , 即 规定 目标 属性 值 开头 的 第 一 个 字符 ; MaxLen 属 
性 用 于 设置 目标 属性 值 的 最 大 字符 串 长 度 。 
步骤 3: 声明 一 个 测试 类 ,并 把 MyAttribute 应 用 到 RawName 属性 上 。 


public class Test 
{ 
[My(StartChar = 'k', MaxLen = 7)] 
public string RawName { get; set; } 
} 


RawName 属性 应 用 MyAttribute 后 ,必须 以 字符 “k” 开 类 限制 它 的 值 ,并 且 长 度 不 能 
来 条 中 
步骤 4: 在 Program 类 中 声明 一 个 静态 方法 ,在 运行 阶段 验证 Test 对 象 的 属性 值 是 否 
满足 MyAttribute 实例 中 所 设 定 的 限制 。 详 见 代码 清单 4-6。 
代码 清单 4-6 ”CheckTest 方 法 


static bool CheckTest (Test t, string property) 
{ 

// 获取 类 型 信息 

Type type = t.GetType(); 
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// 查找 属性 成 员 
PropertyInfo prop = type. GetProperty (property, BindingFlags. Public | BindingFlags. 
Instance); 
if (prop == null) 
{ 
return false; 
} 
// 获取 特性 
MyAttribute att = prop.GetCustomAttribute < MyAttribute >(); 
// 获取 实例 的 属性 值 
string value = prop.GetValue(t) as string; 
if (string. IsNullOrEmpty(value)) 
return false; 
// 进行 验证 
if (value. StartsWith(att. StartChar) == false) 
return false; 
if (value. Length > att. MaxLen) 
return false; 
return true; 


} 


PropertyInfo 类 表示 与 属性 有 关 的 信息 ,调用 它 的 GetValue 方法 可 以 获取 属性 的 当前 
值 。 将 属性 的 当前 值 与 MyAttribute 实例 中 指定 的 值 进行 比较 ,可 以 验证 属性 值 是 否 符合 
步骤 5: 在 Main 方法 中 实例 化 Test 对 象 ,为 RawName 属性 设 定 一 个 测试 值 。 


Test v = new Test { RawName = "k003d6ex915f" }; 
步骤 6: 调用 CheckTest 方法 对 以 上 Test 实例 的 RawName 属性 进行 验证 。 


bool b = CheckTest(v, nameof(Test.RawName)); 
if (b) 

Console. WriteLine( "验证 通过 。"); 
else 

Console. WriteLine(" 验 证 失败 ."); 


虽然 Test 对 象 的 RawName 属性 是 以 字符 “k” 开 头 , 但 是 其 长 度 已 超过 7, 因 此 验证 
失败 。 

实例 98 方法 的 返回 值 如 何 应 用 特性 

【导语 】 

- 般 情 况 下 ,特性 会 自动 应 用 到 跟随 其 后 的 对 象 上 。 例 如 要 把 特性 应 用 到 类 上 ,就 将 特 
性 写 在 类 声明 之 前 ; 要 把 特性 应 用 到 属性 上 ,就 将 特性 写 在 属性 声明 之 前 。 如 以 下 代码 
所 示 。 
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[ComVisible(true)] 
public class Checker 
{ 
[MyCust] 
public int SomeValue { get; set; } 
# 
然而 ,这 种 常规 做 法 并 不 能 将 特性 应 用 到 方法 的 返回 值 上 ,因为 一 般 无 须 在 代码 中 直接 
命名 返回 值 。 这 时 就 要 严格 使 用 特性 的 规范 格式 了 。 应 用 特性 的 规范 格式 如 下 所 示 。 
[ <target >: <attribute> ] 
其 中 ,< target > 是 特性 要 应 用 的 目标 对 象 ,例如 要 应 用 到 类 上 ,可 以 写 为 以 下 形式 。 
[ type: SomeAttribute ] 
通常 可 以 省 略 “type:”。 
对 于 方法 的 返回 , 则 必须 将 特性 的 应 用 目标 指定 为 return, 如 下 所 示 。 


[return: OtherAttr] 
int TestMethod() { return 0; } 


【操作 流程 】 
步骤 1: 新建 控 制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 自 定 义 特性 类 ,限定 该 特性 仅 应 用 于 返回 值 。 


[attributeUsage(RttributeTargets. ReturnValue) ] 
public class CheckSumAttribute : Attribute 

{ 

} 


步骤 3: 在 Program 类 中 添加 一 个 静态 方法 。 


static string SaySomething() => "Hello"; 


步骤 4: 把 上 面 定义 的 CheckSumAttribute 应 用 到 SaySomething 方法 的 返回 值 上 。 


[return: CheckSum] 
static string SaySonething() => "Hello"; 


4.6 运算 符 


实例 99 计算 一 个 整数 的 阶乘 


【导语 】 
本 实例 主要 演示 数学 运算 符 的 使 用 。 常 见 的 数学 运算 符 有 “十 “一 ”x* ”“/”“%” 等 。 
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阶乘 的 计算 方法 : 假设 要 计算 5 的 阶乘 ,计算 结果 为 1 *2*3*4*5。 

【操作 流程 】 

步骤 1: 新建 控 制 台 应 用 程序 项 目 。 

步骤 2: 在 Program 类 中 添加 一 个 Compute 方法 ,传人 一 个 整数 值 ,返回 该 整数 值 的 阶乘 。 


static long Compute(int num) 
{ 
if (num == 0) 
return — 1L; 
long res = 1L; 
int temp = 1; 
while(temp <= num) 
{ 
res = res * temp; 
tempt++; 
} 
return res; 


} 

通过 循环 语句 来 完成 阶乘 的 计算 。 声 明 一 个 临时 变量 temp, 初 始 化 为 1, 每 一 轮 循环 
都 将 该 临时 值 与 res 变量 的 值 相 乘 ,然后 将 temp 的 值 增 加 1, 直 到 temp 的 值 大 于 num 
为 止 。 

步骤 3: 使 用 Compute 方法 计算 4 的 阶乘 。 


longr = Compute(4); 
Console. WriteLine( $ "4 的 阶乘 为 :{r}"); 


步骤 4: 运行 项 目 , 输 出 结果 如 下 。 


4 的 阶乘 为 :24 
实例 100” 按 位 平移 
【导语 】 


运算 符 “<<” 是 将 一 个 数值 的 二 进 制 位 向 左 平移 ,运算 符 “>>” 是 将 之 向 右 平 移 。 例 如 表 
达 式 “10111 >> 2”, 将 数值 10111 的 二 进 制 位 向 右 移 两 位 , 变 成 00101, 后 面 的 两 个 1 在 平移 
时 被 截 掉 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 两 个 int 类 型 的 变量 ,用 于 稍 后 做 测试 。 


int x = 305; 
int y = 1060; 
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步骤 3: 将 变量 x 的 二 进 制 位 向 左 移动 3 个 二 进 制 位 。 
WriteLine( $"{Convert. ToString(x, 2)} 向 左 移动 3 位 ,得 到 {Convert. ToString(x << 3, 2)}"); 
步骤 4: 将 变量 y 的 值 向 右 移动 4 个 二 进 制 位 。 
WriteLine( $"{Convert. Tostring(y, 2)} 向 右 移动 4 位 ,得 到 {Convert. Tostring(y >> 4, 2)}"); 
注意 : Convert. ToString 方法 的 第 二 个 参数 用 于 指定 数值 转换 为 字符 串 后 输出 的 进 制 ,2 
表示 返回 二 进 制 的 字符 串 表 示 形 式 。 


步骤 5: 按 下 快捷 键 F5 运行 项 目 ,控制 台 窗口 的 输出 结果 如 图 4-21 所 示 。 


4-21 二 进 制 位 平移 结果 


实例 101 是 “大 ”还 是 “小 ” 
【导语 】 
“7? … : ”是 三 目 运算 符 , 问 号 前 面 是 一 个 必须 返回 布尔 值 的 表达 式 ,如果 表 达 式 为 
真 ,就 执行 冒号 前 面 的 表达 式 ,否则 就 执行 冒号 后 面 的 表达 式 。 例 如 : 
LT 
于 1 大 于 3 不成立, 所 以 运算 符 返回 字符 串 “ 小 于 ”。 
【操作 流程 】 
步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 字符 串 类 型 的 变量 ,并 进行 初始 化 。 
string s = "abcdefg"; 
步骤 3: 使 用 *? … : …” 运 算 符 对 字符 串 的 长 度 进行 分 析 ,如果 字符 串 长 度 小 于 或 等 于 
5 则 返回 “字符 串 长 度 不 超过 5”, 否 则 返回 “字符 串 长 度 已 超过 5”。 


string msg = "字符 串 长 度 ” + (s.Length<= 5? "不 超过 5”: "已 超过 5"); 
Console. WriteLine(msg); 


步骤 4: 运行 应 用 程序 项 目 ,由 于 字符 串 的 长 度 为 7, 其 值 已 经 大 于 5, 因 此 应 用 程序 输 
出 内 容 如 下 。 


字符 串 长 度 已 超过 5 
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实例 102 typeof 运算 符 的 作用 


【导语 】 

除了 可 以 调用 对 象 实例 的 GetType 方法 来 获取 Type 实例 外 ,还 可 以 使 用 typeof 运算 
符 。 使 用 该 运算 符 的 优点 是 不 需要 事先 创建 类 型 实例 ,直接 将 类 型 名 称 传递 给 运算 符 就 能 
得 到 对 应 的 Type 实例 。 

Type 类 封装 与 某 个 类 型 相关 的 各 种 信息 ,例如 类 型 名 称 、 所 继承 的 基 类 、 是 否 为 泛 型 类 型 
等 。 通 过 Type 类 实例 还 可 以 对 指定 类 型 使 用 反射 技术 ,例如 在 运行 阶段 动态 调用 某 个 方法 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 抽象 类 。 


public abstract class Person 


{ 
public abstract int Age { get; set; } 
} 


步骤 3: 使 用 typeof 运算 符 获 取 该 类 型 相关 的 Type 对 象 。 
Type t = typeof(Person); 
步骤 4: 获取 该 类 型 的 一 些 基本 信息 。 


Console. WriteLine( $ "完整 类 名 :{t. FullName}"); 
Console. WriteLine(" 是 否 为 抽象 类 :{0}"，t. IsAbstract ? "是 " : "和 否 "); 
Console. WriteLine( "是否 为 公共 类 :{0}",t. IsPublic ? "是 ”:" 否 "); 


步骤 5: 通过 反射 , 列 出 该 类 型 的 公共 属性 。 


PropertyInfo[ ] props = t.GetProperties(BindingFlags.Public | BindingFlags. Instance); 

Console. WriteLine("\n\n——-—— 属性 列表 ----- ey 

foreach(var p in props) 

| Console. WriteLine( $ "{p. Name, — 15} {p. PropertyType. Name, 

= 村“ 

} 

PropertyInfo 类 的 Name 属性 可 以 获得 属性 的 名 称 ， 
PropertyType 属性 可 以 返回 该 属性 的 类 型 相关 的 Type 对 象 。 

步骤 6: 按 F5 快捷 键 运行 应 用 程序 项 目 ,输出 结果 如 
图 4-22 所 示 。 图 4-22 输出 类 型 信息 


属性 列表 - 
| 
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实例 103 ”使 用 “十 ”运算 符 将 两 个 对 象 的 属性 值 相 加 


【导语 】 

通过 对 运算 符 重 载 ,开发 人 员 可 以 根据 自己 的 需要 扩展 运算 符 的 功能 。 例 如 本 实例 ,要 
让 “十 ”运算 符 能 够 将 两 个 对 象 实例 的 各 个 属性 值 全 部 相 加 ,就 需要 对 “十 ”运算 符 进行 重 载 。 

重 载运 算 符 时 要 注意 以 下 几 点 : 

(1) 重 载 的 运算 符 最 好 是 公共 成 员 ,方便 在 类 的 外 部 访问 。 

(2) 重 载 的 运算 符 应 为 静态 成 员 ,因为 运算 符 一 般 是 直接 使 用 的 ,与 特定 的 对 象 实例 关 
系 不 大 。 

(3) 重 载运 算 符 时 需要 使 用 operator 关键 字 。 

(4) 重 载运 算 符 成 员 的 参数 就 是 运算 符 的 操作 数 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 测试 类 ,该 类 公开 两 个 int 类 型 的 属性 。 


class Test 
{ 
public int Vall { get; set; } 
public int Val2 { get; set; } 
} 


步骤 3: 重 载 “十 "运算 符 , 把 参与 计算 的 两 个 操作 数 (Test 类 实例 ) 的 公共 属性 的 值 进 
行 相 加 。 


public static int operator + (Test a, Test b) 


和 
return a.Vall + a.Val2 + b.Vall + b.Val2; 


} 


重 载 后 ,“ 十 ”运算 符 的 计算 结果 为 int 类 型 。 
步骤 4: 在 Main 方法 中 ,实例 化 两 个 Test 对 象 。 


Test tl = new Test { Vall = 5, Val2 = 9}; 
Test t2 = new Test { Vall = 2, Val2 -= 6}; 


步骤 5: 使 用 “十 ”运算 符 将 以 上 两 个 变量 进行 相 加 。 


int result = tl + t2; 


Console. WriteLine(" 两 个 对 象 的 属性 值 相 加 结果 :{0}"，zresult) 
步骤 6: 按 下 快捷 键 F5 运行 应 用 程序 项 目 ,输出 结果 如 下 。 
两 个 对 象 的 属性 值 相 加 结果 :22 
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实例 104 对 null 进行 判断 

【导语 】 

有 些 时 候 ,在 调用 某 个 类 的 实例 成 员 时 ,必须 先 检查 实例 是 否 为 null。 标 准 的 做 法 如 下 
(假设 d 是 一 个 变量 )。 

if(d!= null) 

{ 


d. DoSomething( ); 
} 


为 了 让 代码 显得 更 为 简洁 .在 调用 实例 成 员 时 可 以 在 变量 名 称 后 面 加 上 一 个 “?”( 英 文 
的 问号 ) 运 算 符 ,然后 再 访问 实例 成 员 。 加 上 该 运算 符 后 .只 有 当 实 例 不 为 null 的 前 提 下 代 
码 才 会 执行 ,否则 就 跳 过 该 行 代码 。 所 以 上 面 的 调用 代码 可 以 简写 为 以 下 形式 。 

d?. DoSomething( ); 


读 取 属 性 值 的 时 候 也 可 以 使 用 以 下 方法 。 


string s = d?.Property; 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 A 类 ,其 中 包含 一 个 Work 方法 。 


class A 
{ 

public void Work() => Console. WriteLine("{0} 方法 被 调用 ,", nameof(Work)); 
} 


步骤 3: 定义 一 个 A 类 型 的 变量 并 赋值 新 的 实例 ,然后 调用 其 Work 方法 。 


Ra = new A(); 
a?. Work(); 


由 于 变量 a 并 不 为 null, 因 此 Work 方法 会 被 调用 。 
步骤 4: 再 用 A 类 声明 一 个 变量 ,初始 化 为 null, 然 后 调用 Work 方法 。 


Ap = null; 
p?. Work(); 


此 时 ,因为 变量 p 为 null, 所 以 Work 方法 不 会 被 调用 。 
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4.7 ”类 型 转换 


实例 105 ”强制 转换 


【导语 】 

强制 转换 一 般 用 在 向 * 非 兼容 ?类 型 转换 的 情形 ,因为 转换 会 导致 数据 损坏 。 例 如 将 
double 类 型 的 数值 转换 为 int 类 型 的 数值 ,由 于 int 只 能 容纳 整数 值 , 这 使 得 double 数值 的 
小 数 部 分 丢失 。 

强制 转换 的 方法 是 在 要 转换 的 对 象 前 使 用 小 括号 ,并 在 小 括号 中 指定 目标 类 型 。 例 如 : 

intk = (int)f; 

上 述 代码 将 工 变量 的 值 强制 转换 为 int 类 型 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 


doublea = 5.10985d; 

intb = (int)a; 

Console. WriteLine( $ "{a, -15}{b, -15}"); 

强制 转换 后 ,变量 a 的 小 数 部 分 被 丢弃 , 变 为 5。 
步骤 3: 再 声明 double 类 型 的 变量 c, 然 后 强制 转换 为 int 类 型 并 赋值 给 变量 d。 
double c = 12.8155d; 

intd = (int)c; 

Console. WriteLine( $ "{c, —15}{d, -15}"); 


强制 转换 后 ,变量 c 中 的 小 数 部 分 也 被 丢弃 , 变 为 整 


Ciprogram.. — 口 x 


数 12。 
a a i ， ”图 4-23 double 类 型 数值 转 
步骤 4: 运行 应 用 程序 项 目 ,屏幕 输出 结果 如 图 4-23 换 为 int 类 型 数值 

所 示 。 


注意 : 并 非 所 有 类 型 之 间 都 能 进行 强制 转换 ,例如 不 存在 继承 关系 的 类 之 间 不 能 转换 、 枚 举 
与 委托 之 间 不 能 进行 转换 等 。 


实例 106 将 int 数值 隐 式 转换 为 double 数值 


【导语 】 
double 类 型 的 数值 包括 整数 部 分 与 小 数 部 分 ,而 int 类 型 的 数值 仅 包 含 整数 部 分 。 当 
int 类 型 的 数值 赋值 给 double 类 型 的 变量 时 ,是 不 需要 强制 转换 的 ,直接 进行 赋值 即 可 , 因 
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为 从 int 到 double 之 间 存 在 隐 式 转换 ,转换 之 后 不 会 造成 数据 丢失 。 例 如 ,整数 13 转换 为 
double 类 型 值 会 变 为 13. 000 ,数值 依然 是 13, 不 存在 被 丢弃 的 数据 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 三 个 int 类 型 的 变量 并 进行 初始 化 。 


intx = 28,y = 66,z = 312; 
步骤 3: 声明 三 个 double 类 型 的 变量 ,并 分 别 用 上 面 的 三 个 int 变量 进行 初始 化 。 
tonbles = YE, £m yg 
由 于 此 处 属于 隐 式 转换 ,因此 直接 进行 赋值 即 可 。 
步骤 4: 将 上 面 三 组 数值 输出 到 屏幕 (包括 转换 前 与 转 
换 后 )。 


Console. WriteLine( $ "{x, -15}{e, - 15:0.000}"); 

Console. WriteLine( $ "{y, ~ 15}{f£, -15:0.000}"); 

Console. WriteLine( $ "{z, 一 15}{g, ~ 15:0.000}"); 

代码 中 的 “: 0.000” 用 于 设置 输出 字符 串 的 格式 ,0. 000 
表示 保留 三 位 小 数 。 

步骤 5: 运行 应 用 程序 项 目 .输出 结果 如 图 4-24 所 示 。 图 4-24 数值 间 的 隐 式 转换 结果 


实例 107 输出 整数 的 二 进 制 表 示 形 式 


【导语 】 
Convert 类 公开 了 一 组 可 以 将 整数 数值 转换 为 字符 串 的 方法 : 


string ToString(byte value, int toBase); 
string ToString(int value, int toBase); 


string ToString(long value, int toBase); 

string ToString( short value, int toBase); 

从 上 面 所 列 出 的 方法 来 看 , 受 支 持 的 整数 类 型 有 byte、int、long、short。 所 有 方法 都 有 

-个 toBase 参数 ,该 参数 为 一 个 int 类 型 的 值 。 作 用 是 指定 整数 值 转换 为 字符 串 后 所 呈现 

的 进 制 形式 。 所 以 toBase 参数 的 值 是 不 可 以 随意 指定 的 ,有 效 值 为 2、8、10、16, 分 别 对 应 二 
进 制 ,八进制 ,十进制 和 十 六 进 制 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 四 个 变量 ,类 型 分 别 为 byte、int、long、short。 

byte vi = 155; 

int v2 = 916652; 
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long v3 = 1200365172; 
short v4 = 5185; 


步骤 3: 使 用 Convert, ToString 方法 将 以 上 四 个 变量 的 值 转换 为 二 进 制 字 符 串 .3 
出 到 控制 人 台 窗 口中 。 


用 
三 
EE 


Console. WriteLine( $ "{v1, - 15} {Convert. ToString(v1, 2), - 80}"); 
Console. WriteLine( $ "{v2, ~ 15}{Convert. ToString(v2, 2), — 80}"); 
Console. WriteLine( $ "{v3, - 15} {Convert. ToString(v3, 2), - 80}"); 
Console. WriteLine( $ "{v4, - 15}{Convert. ToString(v4, 2), — 80}"); 


步骤 4: 运行 应 用 程序 项 目 ,输出 结果 如 图 4-25 所 示 。 


1010001000001 


图 4-25 输出 整数 值 的 二 进 制 形式 


实例 108 ”将 字 节 数组 转换 为 字符 串 


【导语 】 

BitConverter 类 是 有 特定 用 途 的 类 型 转换 辅助 类 , 它 主要 完成 基础 类 型 与 字 节 数组 之 
间 的 转换 操作 。 其 中 ,ToString 方法 可 以 将 一 个 字 节 数组 转换 为 单个 字符 串 实 例 ,数组 
的 每 字 节 均 输 出 为 两 位 十 六 进 制 数 , 字 节 与 字 节 之 间 用 字符 “-” 连 接 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 字 节 数组 ,并 进行 初始 化 。 


bytel ] hoffer = {137 12, 5; 2, 7, 51,. 19, 53, 135 $: 


步骤 3: 调用 BitConverter. ToString 方法 ,获得 转换 后 的 字符 串 。 


dT 


由 


string str = BitConverter.ToString(buffer); 
Console.WriteLine(str) 


步骤 4: 运行 应 用 程序 项 目 , 将 看 到 以 下 输出 结 


03—0Cc-05-5C-07-3D-12-35-87 
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实例 109 ” 重 写 ToString 方法 


【导语 】 

Object 类 包含 一 个 虚 方 法 一 一 ToString。 由 于 Object 是 各 种 数据 类 型 的 基 类 ,因此 类 
型 编写 者 可 以 重 写 ToString 方法 ,以 便 能 够 自 定 义 类 型 的 字符 串 表 示 形 式 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 Production 类 ,并 公开 一 些 属性 。 


public class Production 
{ 
public int ID { get; set; } 
public int Width { get; set; } 
public int Height { get; set; } 
public string SerialNum { get; set; } 
} 


步骤 3: 在 Production 类 中 重 写 ToString 方法 ,返回 自 定义 字符 串 ,字符 串 可 以 由 该 类 
的 属性 值 组 成 。 


public class Production 


. 


public override string ToString() 
{ 
return $ "产品 序列 号 :{SerialNum}, 规格 (厘米 ) :{Width} x {Height}"; 
} 
} 


步骤 4: 在 Main 方法 中 实例 化 一 个 Production 数组 。 


Production[ ] prs = 
{ 


new Production 


{ 


ID=1, 
Width = 150, 
Height = 70, 


SerialNum = "T— 312756— K3" 
}， 
new Production 
{ 

ID=2, 

Width = 200, 

Height = 85, 

SerialNum = "T— 33158—K7" 
}, 
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new Production 
ID=3, 
Width = 210, 
Height = 75, 
SerialNum = "T 一 23158 一 K8" 
}， 
new Production 
{ 
全 
Width = 270, 
Height = 56, 
SerialNum = "T— 600001— C4" 
}, 
new Production 
{ 
ID=5, 
Width = 260, 
Height = 90, 
SerialNum = "T—712558— C7" 


}; 


步骤 $: 调用 Console. WriteLine 方法 将 数组 中 的 每 个 Production 对 象 的 字符 和 
形式 输出 到 窗口 上 ,WriteLine 方法 会 自动 调用 实例 的 ToString 方法 。 


涡 
ll 


foreach (Production p in prs) 


{ 


Console. WriteLine(p); 


} 
步骤 6: 按 下 F5 快捷 键 运行 应 用 程序 项 目 , 屏 幕 输出 结果 如 图 4-26 所 示 。 


图 4-26 调用 ToString 方 法 输出 自 定义 字符 串 


实例 110 ”将 整数 转换 为 十 六 进 制 字符 串 


【导语 】 

许多 基础 类 型 都 公开 可 以 设置 格式 参数 的 ToString 方法 ,支持 使 用 格式 化 字符 串 来 确 
定 要 返回 的 字符 串 格式 。 例 如 ToString(*N”) 可 以 将 数值 以 常规 数据 格式 返回 , 即 每 隔 三 
位 就 有 一 个 英文 的 逗号 , 形 如 23,355,456. 22。 
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十 六 进 制 字符 串 的 格式 符号 为 “x”, 如 果 字 符 串 为 大 写 ( 即 “X”), 则 返回 的 十 六 进 制 格 
式 中 将 以 大 写字 母 来 呈现 , 即 A.B\C\ DEF。 格 式 符号 后 有 时 候 可 以 跟 一 个 数字 2 ,表示 
使 用 两 位 数 来 描述 一 字 节 ,例如 3 的 “X2? 格 式 将 返回 “03”,255 的 “X2? 格 式 则 返回 “FF”。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 int 类 型 的 变量 并 初始 化 。 


int x = 91545588; 

步骤 3: 输出 该 变量 的 十 六 进 制 形式 。 

Console. WriteLine("{0} 一 > 0x{1}", x, x.ToString("x2")); 
步骤 4: 运行 应 用 程序 项 目 ,输出 结果 如 下 。 


91545588 一 > 0x574dff4 


实例 111 自 定义 隐 式 转换 


【导语 】 

在 默认 情况 下 ,不 同类 型 之 间 是 无 法 进行 转换 的 ,尤其 是 引用 类 型 与 值 类 型 之 间 更 不 可 
能 进行 转换 。 但 是 ,为 了 便于 开发 者 实现 一 些 特殊 的 转换 ,语言 规范 允许 使 用 类 似 运算 符 重 
载 的 方式 来 实现 自 定义 的 转换 。 书 写 格式 如 下 。 
的 类 型 > ( < 待 转换 的 类 型 > ) {…} 

public static explicit operator < 返回 的 类 型 > ( < 待 转换 的 类 型 > ) { …} 

implicit 关键 字 表 示 隐 式 转换 ,explicit 关键 字 表 示 显 式 转换 。 两 者 的 不 同 在 于 : 隐 式 
转换 通过 赋值 可 以 自动 完成 转换 ,例如 派生 类 的 实例 可 以 直接 赋值 给 用 基 类 声明 的 变量 ; 
显 式 转换 需要 强制 转换 ,例如 double 类 型 的 值 要 赋值 给 int 类 型 的 变量 ,就 需要 在 赋值 时 进 
行 强制 转换 。 

本 实例 将 演示 从 自 定义 类 到 int 类 型 的 隐 式 转换 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 类 ,表示 一 个 甜 形 的 相关 信息 ,其 中 包含 矩形 的 宽度 和 高 度 。 


public static implicit operator < 返 


加 
加 


public class RectArea 
{ 
public RectArea( int width, int height) 
{ 
Width = width; 
Height = height; 
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public int Width { get; } 
public int Height { get; } 


} 
步骤 3: 为 了 通过 隐 式 转换 来 获得 矩形 的 面积 ,需要 在 RectArea 类 中 添加 自 定义 转换 
的 实现 。 


public class RectArea 
| 


public static inplicit operator int(RectArea r) 
{ 
return r. Width * r.Height; 


3: 


注意 : 自 定义 的 转换 需要 声明 为 静态 成 员 , 因 为 转换 是 面向 类 型 的 ,而 不 是 面向 对 象 实 
例 的 。 


步骤 4: 在 Main 方法 中 实例 化 RectArea 对 象 。 
RectAreav = new RectArea(12, 15); 

步骤 5: 声明 int 类 型 的 变量 ,并 直接 将 RectArea 实例 赋值 给 它 。 
int area = T7 

步骤 6: 输出 矩形 的 属性 及 其 面积 。 


Console. WriteLine( $ "矩形 信息 :\n 宽 :{v. Width}\n 高 :{v. Height}\ 
n 面积: {area}"); 


步骤 7: 运行 应 用 程序 项 目 , 控 制 台 窗口 输出 结果 如 图 4-27 
所 示 。 


4.8 可 以 为 null 的 值 类 型 


图 4-27 输出 矩形 面积 


实例 112 ”访问 可 以 为 null 的 值 类 型 

【导语 】 

允许 值 类 型 为 null 的 主要 应 用 场景 是 面向 数据 库 的 编程 ,因为 数据 表 的 字段 都 可 能 为 
null。 当 数据 模型 类 与 数据 库 对 象 映射 时 ,模型 类 公开 的 属性 值 就 可 以 使 用 为 null 的 值 
类 型 。 
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声明 可 以 为 null 的 值 类 型 变量 时 ,有 两 种 方法 : 

第 一 种 是 直接 使 用 . NET 类 型 Nullable< 工 >, 例 如 以 下 形式 。 

Nullable< byte>b = null; 

第 二 种 是 使 用 C# 语 言 的 特定 语法 ,例如 以 下 形式 。 

byte? b = null; 

在 运行 阶段 ,以 上 两 种 方法 所 声明 的 变量 类 型 相同 。 

要 获取 Nullable<T> 类 型 实例 的 值 , 可 以 访问 Value 属性 。 由 于 Nullable < 了 > 类 型 
的 变量 值 有 可 能 为 null, 因 此 最 好 不 要 直接 访问 Value 属性 ,而 是 先 检查 一 下 HasValue 属 
性 是 否 为 true, 如 果 为 true 说 明 存 在 有 效 值 ,否则 就 为 null。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 可 以 为 null 的 int 类 型 变量 并 初始 化 为 null。 


int? x = null; 
步骤 3: 检索 变量 x 中 的 值 。 


if (x.HasValue) 

Console. WriteLine(" 变 量 x 的 值 为 :{0}."，x. Value); 
else 

Console. WriteLine(" 变 量 x 为 nu11."); 


步骤 4: 再 声明 一 个 可 以 为 null 的 double 类 型 的 变量 ,初始 化 时 分 配 一 个 有 效 的 值 。 
double? y = 91.3d; 


步骤 $: 检索 变量 y 中 的 值 。 


证 (Y.HasValue) 
Console. WriteLine( "变量 y 的 值 为 :{0}."，Y. Value); 
else 
Console. WriteLine(" 变 量 y 为 no11."); 
步骤 6: 运行 应 用 程序 项 目 ,程序 输出 结果 如 图 4-28 
所 示 。 


实例 113 ”为 Nullable <T> 实 例 分 配 默认 值 

【导语 】 

在 获取 Nullable < 全 > 实例 的 值 时 ,如 果 每 次 都 检查 HasValue 属性 会 很 麻烦 ,此 时 可 
以 考虑 当 实 例 为 null 时 自动 返回 一 个 默认 值 。 

假设 变量 a 是 Nullable < int > 类 型 实例 ,在 获取 int 值 时 如 果 为 null 就 返回 默认 值 5。 


图 4-28 输出 Nullable 
<T> 实 例 的 值 
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语法 如 下 。 
int val = a?? 5; 


这 个 运算 符 由 两 个 英文 的 问号 组 成 。 如 果 变 量 a 不 为 null, 就 返回 变量 a 的 实际 值 ; 如 
果 变 量 a 为 null, 就 返回 *??” 后 面 的 内 容 , 即 数值 5。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Nullable < int > 类 型 的 变量 ,初始 化 为 null。 


int? c = null; 
步骤 3: 通过 “??” 运 算 符 获取 变量 c 的 值 ,如 果 为 null ,默认 返回 25。 
inkr = Ce Ye 25» 


因为 变量 c 初 始 化 时 分 配 为 null, 因 此 赋值 后 变量 r 的 值 是 25。 
步骤 4: 再 声明 一 个 Nullable < int > 类 型 的 变量 ,这 次 给 它 分配 一 个 有 效 值 。 


int? d = 100; 
步骤 5: 获取 变量 d 的 值 , 存 储 到 变量 s 中 。 
ints = d??8; 


变量 d 中 包含 有 效 值 100 ,赋值 后 变量 s 的 值 为 100 ,而 不 是 8。 


数学 运算 与 字符 串 处 理 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 ， 
。 简单 数学 计算 ; 

。 日 期 /时 间 换算 ， 

， 常 用 的 字符 串 处 理 ; 

格式 控制 符 ， 

。 从 字符 串 到 其 他 类 型 的 转换 。 


5.1 简单 数学 计算 


实例 114 求 一 组 整数 中 的 最 大 值 和 最 小 值 


【导语 】 

-组 整数 (主要 是 int 类 型 ) 可 以 用 int 数组 来 存储 ,也 可 以 用 List < int > 类 来 存储 。 要 

次 性 计算 出 一 组 数值 中 的 最 大 值 与 最 小 值 ,可 以 借助 一 个 辅助 类 一 一 Enumerable( 位 于 
System. Lind 命名 空间 下 ) ,该 类 提供 了 许多 扩展 方法 ,可 以 对 集合 .列表 、 数 组 中 的 元 素 进 
行 各 种 计算 与 处 理 。 本 例 将 使 用 Max 方法 和 Min 方法 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 代码 文件 顶部 引入 以 下 命名 空间 。 


using System. Ling; 


步骤 3: 声明 一 个 int 数组 ,并 用 一 些 整数 值 进行 初始 化 。 


int[] srcarr = { 102, 45, 17, 325, 6, 199, 207, 416, 736, 94, 27 }; 
步骤 4: 调用 Max 方法 筛选 出 数组 中 的 最 大 值 。 

Console. WriteLine( $"\n 其 中 ,最 大 的 数 为 :{srcarr. Max()}"); 

步骤 5: 调用 Min 方法 筛选 出 最 小 值 。 
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Console. WriteLine( $" 最 小 的 值 为 :{srcarr. Min()}"); 


步骤 6: 按 下 F5 快捷 键 运行 ,输出 结果 如 图 5-1 所 示 。 


图 5-1 输出 最 大 值 与 最 小 值 


实例 115 ”计算 平均 值 


【导语 】 

Average 扩展 方法 可 用 于 计算 一 个 数值 序列 的 平均 值 , 支 持 的 输入 类 型 有 int\long、 
float double。 而 计算 结果 通常 返回 float( 单 精度 数值 ) 或 double( 双 精度 数值 ) 两 种 类 型 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 double 类 型 的 数组 ,并 进行 初始 化 。 

double[ ] src = 


{ 
20.55d, 4.7d, 0.92d, 5.886d, 110.6d 


}; 
步骤 3: 计算 以 上 数组 中 所 有 元 素 的 平均 值 ,并 输出 
到 控制 台 窗 口中 。 


Console. WriteLine( $ "其 平均 值 为 :{src. Average()}"); 


步骤 4: 运行 应 用 程序 项 目 ,其 输出 的 平均 值 如 图 5-2 


图 5-2 求 得 数组 的 平均 值 


所 示 。 
实例 116 ”计算 一 个 数值 的 绝对 值 
【导语 】 


Math 类 提供 与 数学 运算 相关 的 一 系列 静态 方法 ,可 以 直接 调用 ,包括 求 绝对 值 \ 求 最 
大 或 最 小 值 , 三 角 函 数 , 指 数 备 等 。 

本 实例 将 使 用 Abs 方法 返回 输入 数值 的 绝对 值 , 支 持 的 输入 类 型 有 : 整数 , 单 精度 小 
数 、 双 精度 小 数 以 及 有 符号 字 节 。 
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【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 代码 文件 中 使 用 using static 指令 引入 Math 类 。 由 于 该 类 是 静态 类 ,引入 后 
可 以 在 代码 中 直接 访问 其 公共 方法 ,而 无 须 输 入 类 名 。 

using static System. Math; 


步骤 3: 声明 四 个 变量 ,用 于 稍 后 做 测试 。 


double nl = —3.0112d; 
int n2 = 9060; 
float n3 = 一 15.3f) 


decinmal n4 = 417.63M; 


步骤 4: 调用 Abs 方法 计算 以 上 四 个 变量 值 的 绝对 值 ， 
并 输出 到 控制 台 窗口 中 。 


WriteLine( $"{n1l} 的 绝对 值 = {Abs(n1)}"); 


WriteLine( $"{n2} 的 绝对 值 = {Abs(n2)}"); 
WriteLine( $ "{n3} 的 绝对 值 = {Abs(n3)}"); 
WriteLine( $ "fn4} 的 绝对 值 = {Abs(n4)}"); 图 5-3 ”四 个 数值 的 绝对 值 


步骤 5: 运行 应 用 程序 项 目 ,输出 结果 如 图 5-3 所 示 。 
实例 117 计算 一 个 矩形 序列 的 周 长 总 和 


【导语 】 

计算 一 个 矩形 的 周 长 , 需 要 将 相 邻 的 两 条 边 长 相 加 再 乘 以 2。 本 实例 同时 也 将 使 用 
Enumerable 类 的 Sum 扩展 方法 ,以 计算 所 有 和 矩形 的 周 长 总 和 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 System. Linq 命名 空间 。 


using System. Ling; 
步骤 3: 声明 一 个 Rectangle 结构 ,用 以 封装 矩形 的 宽度 与 高 度 。 


struct Rectangle 
{ 
public float Width; 
public float Height; 
} 


步骤 4: 在 Main 方法 中 声明 一 个 Rectangle 数组 ,并 使 用 4 个 Rectangle 实例 进行 初始 化 。 


Rectangle[ ] rects = 


lk 
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new Rectangle{ Width = 16.3f, Height = 7f }, 

new Rectangle{ Width = 24.5f, Height = 10f }, 

new Rectangle{ Width = 9.6f, Height = 8.5f }, 

new Rectangle{ Width = 4f, Height = 12.3f } 
入 


步骤 5: 计算 这 些 矩形 的 周 长 之 和 。 


和 ET 


float lens = rects.Sum(r => (r.Width + r.Height) * 2f); 

Sum 方法 中 使 用 了 一 个 委托 ,在 计算 总 和 的 时 候 ,Sum 方法 会 把 每 个 元 素 ( 此 处 是 
Rectangle 实例 ) 都 传递 到 这 个 委托 ,并 获取 计算 出 来 的 局 部 结果 ,再 把 所 有 的 局 部 结果 进行 
相 加 ,以 确定 最 终 的 值 .在 该 委托 中 ,应当 返回 单个 矩形 的 周 长 。 

步骤 6: 运行 应 用 程序 ,输出 如 下 结果 。 


以 上 4 个 矩形 的 周 长 总 和 为 :184.4 


实例 118 求 某 个 角度 的 正弦 值 

【导语 】 

Math 类 提供 了 计算 三 角 丙 数 的 相关 方法 。 例 如 ,Sin 方法 可 用 于 计算 正 将 值 ,Cos 方法 
可 用 于 计算 余 弘 值 等 。 

不 过 ,这 些 方法 的 输入 参数 皆 为 弧度 角 , 而 人 们 习惯 使 用 角度 值 ,因此 在 传递 参数 的 时 
候 ,需要 使 用 以 下 换算 公式 将 角度 值 转换 为 弧度 角 ， 


弧度 角 二 角度 值 X 一 


180 
圆周 率 (r) 的 值 可 以 访问 Math 类 的 PI 常量 获取 。 
【操作 流程 】 


步骤 1: 新建 控 制 台 应 用 程序 项 目 。 
步骤 2: 分 别 计算 15"、.30"、45"、60"、90" 的 正弦 值 。 


Console. WriteLine( $ "15 度 的 正弦 值 :{Math.Sin(15 * Math.PI / 180)}"); 
Console. WriteLine( $ "30 度 的 正弦 值 :{Math.Sin(30 * Math.PI / 180)}"); 
Console. WriteLine( $ "45 度 的 正弦 值 :{Math. Sin(45 * Math.PI / 180)}"); 
Console. WriteLine( $ "60 度 的 正弦 值 :{Math.Sin(60 * Math.PI / 180)}"); 
Console. WriteLine( $ "90 度 的 正弦 值 :{Math.Sin(90 * Math.PI / 180)}"); 
在 调用 Sin 方法 的 时 候 ,要 将 角度 转换 为 弧度 角 。 
以 30 度 为 例 , 将 角度 值 先 乘 以 Math. PI, 再 除 以 180 。 


30 * Math.PI / 180 
步骤 3: 运行 应 用 程序 项 目 ,输出 结果 如 图 5-4 
所 示 。 


图 5-4 各 角度 值 的 正弦 值 
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实例 119 求 某 个 数值 的 立方 


【导语 】 

Math 类 的 Pow 方法 的 功能 是 短 运 算 , 其 中 ,参数 x 为 底数 ,参数 y 为 指数 。 要 求 得 某 
个 数值 的 立方 ,只 需要 向 y 参数 传递 3 即 可 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 double 类 型 的 数组 ,数组 中 的 元 素 为 需 
要 进行 备 运 算 的 底数 。 


double[ ] srcnums = { 5d, 3d, 7d, 4d, 6d }; 
步骤 3: 通过 foreach 循环 访问 数组 中 的 元 素 , 并 对 每 个 
元 素 都 进行 指数 为 3 的 客运 算 ( 即 求 立 方 值 )。 


foreach(double d in srcnums) 


{ 


Console. WriteLine("{0} 的 立方 为 :{1}Nn"，d Math. Pow(d, 3d)); 图 5-5 输出 各 数值 的 立方 值 
} 


步骤 4: 运行 应 用 程序 项 目 .输出 结果 如 图 5-5 所 示 。 
实例 120 ”计算 矩形 的 对 角 线 长 度 


【导语 】 

由 于 甜 形 的 四 个 角 都 是 直角 ,并 且 相 对 的 两 条 边 长 度 相 同 , 这 使 得 相 邻 两 条 边 与 对 角 线 
可 以 构成 一 个 直角 三 角形 。 因 此 可 以 运用 勾 股 定理 计算 出 对 角 线 的 长 度 。 

假设 w 表示 算 形 的 宽度 ,bh 表示 矩形 的 高 度 .d 表示 对 角 线 的 长 度 。 那么. 求 对 角 线 长 
度 的 公式 如 下 。 


d= Vw 十 下 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2; 声明 一 个 Rectangle 类 ,包含 与 矩形 相关 的 属性 ,例如 宽度 与 高 度 。 


class Rectangle 
{ 
public Rectangle(double w, double h) 
{ 
Width = w; 
Height = h; 
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public double Width { get; } 
public double Height { get; } 
} 


步骤 3: 在 Rectangle 类 中 添加 一 个 Diagonal 属性 ,返回 对 角 线 的 长 度 。 


class Rectangle 
{ 


public double Diagonal 
{ 
get 
{ 
// 分 别 计算 宽度 与 高 度 的 平方 
double qw = Math.Pow(Width, 2d); 
double qh = Math. Pow(Height, 2d); 
// 将 加 与 qh 相 加 ,再 获取 算术 平方 根 
double res = Math. Sqrt(qw + qh); 


return res; 


} 


首先 调用 Pow 方法 分 别 算出 Width 属性 和 Height 属性 的 平方 ,然后 将 两 个 值 相 加 ,并 
调用 Sqrt 方法 开平 方 根 ,最 后 返回 对 角 线 的 长 度 。 
步骤 4: 在 Main 方法 中 初始 化 Rectangle 对 象 。 


Rectangle rect = new Rectangle(6d, 10d); 


步骤 $: 在 控制 台中 输出 矩形 的 对 角 线 长 度 。 


string message = $ "宽度 : {rect. Widthj \n 高 度 : {rect. 
Heightj\n 对 角 线 长 度 :{rect. Diagonal:N2}"; 
Console. WriteLine(message); 


步骤 6: 运行 应 用 程序 项 目 ,输出 的 对 角 线 长 度 如 图 5-6 图 56 输出 矩形 的 对 角 线 长 度 
所 示 。 


实例 121 处理 超大 整数 

【导语 】 

在 常用 的 整数 类 型 中 ,容量 最 大 的 是 64 位 整数 。 但 是 ,在 一 些 特定 的 应 用 场景 中 ,应 用 
程序 需要 存储 的 整数 值 会 远 远 超过 64 位 整数 的 最 大 值 (例如 ,两 个 64 位 整数 相 乘 ) 。 这 时 
候 , 就 需要 用 到 超大 整数 类 型 一 一 BigInteger( 位 于 System. Numerics 命名 空间 )。 

BigInteger 类 型 的 整数 没有 限定 最 大 值 和 最 小 值 , 也 就 是 说 ,理论 上 它 可 以 存储 无 限 大 
的 整数 。 然 而 受到 计算 机 内 存 的 限制 ,很 难 真正 做 到 “无 限制 大 ”。 当 BigInteger 耗 尽 可 用 
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内 存 时 ,就 会 抛 出 OutOfMemoryException 异常 。 

本 实例 将 使 用 BigInteger 实例 来 存放 整数 300 的 阶乘 运算 结果 ,因为 其 结果 已 远 远 超 
出 64 位 整 的 容量 ,只 能 使 用 BigInteger 类 型 存储 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 计算 300 的 阶乘 ,使 用 BigInteger 对 象 来 保存 结果 。 


intn = 300; 
BigInteger bi = 1; 


int temp = n; 
while(temp > 0) 
{ 
bi * = temp; 
temp——; 
} 
步骤 3: 将 计算 结果 输出 到 屏幕 。 
Console. WriteLine("{0} 的 阶乘 :\n{1}"，n，bi); 
步骤 4: 运行 应 用 程序 项 目 , 屏 幕 输出 结果 如 图 5-7 所 示 。 


Ci\Program Files\dotnet\dotnet.exe es 口 x 


图 5-7 300 的 阶乘 


5.2 日 期 /时 间 换 算 


实例 122 今天 是 星期 几 


【导语 】 

与 日 期 /时 间 有 关 的 数据 由 DateTime 结构 封装 。 其 中 ,DayOfWeek 属性 可 以 获取 某 
个 日 期 是 一 周 中 的 哪 一 天 ,属性 返回 DayOfWeek 枚 举 值 ,该 枚 举 类 型 明确 定义 了 从 星期 日 
到 星期 六 , 共 7 个 常量 值 。 
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访问 静态 属性 Today 可 以 获取 当前 日 期 ,再 访问 DayOfWeek 
期 几 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 项 目 模板 生成 的 Main 方法 中 ,定义 一 个 DateTime 
的 日 期 。 


DateTime today = DateTime.Today; 


步骤 3: 访问 DayOfWeek 属性 。 


Var weekday = today.DayOfWeek; 
步骤 4: 通过 switch 语句 确定 要 输出 的 内 容 。 


string msg = "今天 是 "; 
switch (weekday) 
{ 
case DayOfWeek. Sunday: 
msg += "星期 天 "; 
break; 
case DayOfWeek. Monday: 
msg +- "星期 一 "; 
break; 
case DayOfWeek. Tuesday: 
msg += "星期 二 "; 
break; 
case DayOfWeek. Wednesday: 
msg += "星期 三 "; 
break; 
case DayOfWeek. Thursday: 
msg +=“" 星 期 四 "; 
break; 
case DayOfWeek. Friday: 
msg += "星期 五 "; 
break; 
case DayOfWeek. Saturday: 
msg += "星期 六 "; 
break; 
} 


Console. WriteLine(msg); 


属性 可 以 知道 今天 是 星 


类 型 的 变量 ,并 获取 今天 


步骤 5: 运行 应 用 程序 项 目 后 ,屏幕 上 就 会 输出 当前 日 期 在 一 周 中 的 位 置 ,如 “今天 是 星 


期 至” 


实例 123 ”获取 指定 日 期 的 农历 日 期 

【导语 】 

农历 是 中 国 传统 历法 ,属于 阴阳 历 (并 非 纯 阴历 ), 用 月 相 (朔望月 ) 确 定 每 月 周期 ,并 依 
据 太 阳 年 (回归 年 ) 设 置 二 十 四 节气 。 平 年 为 十 二 个 月 , 闲 年 为 十 三 个 月 ,大 月 三 十 天 ,小 月 
二 十 九天 (朔望月 平均 长 度 为 29. 530588 天 ) 。 

为 了 方便 获取 与 农历 相关 的 信息 ,在 System. Globalization 命名 空间 下 ,提供 了 一 个 专 
门 用 于 计算 中 国 农历 的 ChineseLunisolarCalendar 类 ,该 类 从 EastAsianLunisolarCalendar 
类 派生 (因为 东亚 国家 的 历法 与 农历 有 相似 之 处 ,例如 表示 日 本 历法 的 JapaneseCalendar 类 ) 。 

要 获取 指定 日 期 在 农历 中 的 日 期 ,可 以 分 别 调 用 GetMonth 和 GetDayOfMonth 两 个 方 
法 ,两 个 方法 均 返 回 int 数值 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


using System. Globalization; 
步骤 3: 实例 化 ChineseLunisolarCalendar 对 象 。 
ChineseLunisolarCalendar cncld = new ChineseLunisolarCalendar(); 


步骤 4: 定义 三 个 使 用 公历 表示 的 日 期 ,用 于 稍 后 测试 。 


DateTime dl = new DateTime(2017, 12, 18); 
DateTime d2 = new DateTime(2018, 3, 20); 
DateTime d3 = new DateTime(2018, 5, 15); 


步骤 5: 获取 以 上 三 个 日 期 的 农历 日 期 (包括 月 与 日 )。 


Console. WriteLine( $ "{dl:d}, 农 历 :{cncld. GetMonth(d1)} 月 {cncld. GetDayOfMonth(d1)} 日 "); 
Console. WriteLine( $"{d2:d}, 农 历 :{cncld. GetMonth(d2)} 月 {cncld. GetDayofMonth(d2)} 日 "); 
Console. WriteLine( $"{d3:d}, 农 历 :{cncld. GetMonth(d3)} 月 {cncld. GetDayOfMonth(d3)} 日 "); 


步骤 6: 运行 应 用 程序 项 目 ,输出 结果 如 图 5-8 所 示 。 


图 5-8 输出 指定 日 期 的 农历 


注意 : 由 于 2017 年 存在 闽 六 月 (数值 为 ?7), 因 此 ,农历 12 月 13 日 , 实 为 11 月 13 日 。 
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实例 124 一 天 内 总 共有 多 少 秒 


【导语 】 
DateTime 结构 所 表示 的 是 某 个 特定 的 时 间 点 ,而 TimeSpan 结构 则 可 以 表示 一 个 时 间 


段 , 它 描述 的 是 时 间 区 域 ,例如 一 首 乐 曲 总 时 长 为 00: 03: 47, 这 就 要 使 用 TimeSpan 来 
表示 。 


分 的 


Seco 


TimeSpan 结构 定义 有 Day、Hours、Minutes、Seconds 等 属性 ,用 于 获取 时 间 段 中 各 部 
值 ,例如 上 面 提 到 的 00: 03: 47 ,那么 ,其 Hours 属性 的 值 为 0,Minutes 属性 的 值 为 3， 
nds 属性 的 值 为 47。 
与 这 些 属性 相对 应 的 ,还 有 带 前 级 Total 的 属性 , 如 TotalHours、TotalMinutes、 


TotalSeconds 等 。 这 些 属性 获取 的 是 总 值 ,如 上 面 的 00: 03: 47, 它 的 TotalHours 属性 的 


值 为 


0. 063,TotalSeconds 属性 的 值 为 227, 即 它 的 总 秒 数 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 实例 化 TimeSpan 结构 ,时 间 段 为 24 小 时 。 


TimeSpan s = new TimeSpan(24, 0, 0); 

步骤 3: 从 TotalSeconds 属性 可 以 获取 总 秒 数 。 
string str = $ "一 天 内 总 共有 {s.TotalSeconds} 秒 , "; 
步骤 4: 再 创建 一 个 TimeSpan 实例 ,初始 化 时 间 段 为 3 天 (72 小 时 ) 。 
s = new TimeSpan(3, 0, 0, 0); 

步骤 5: 获取 3 天 时 间 内 的 总 秒 数 。 

str = $ "三 天 内 总 共有 {s.TotalSeconds} 秒 。"; 


步骤 6: 运行 应 用 程序 项 目 ,输出 内 容 如 图 5-9 所 示 。 图 5-9 输出 总 秒 数 
实例 125 日 期 的 加 / 减 运 
【导语 】 


DateTime 结构 提供 了 几 个 以 Add 开头 的 方法 ,如 AddYears、AddMonths、AddDays 


等 ,这 些 方法 可 以 对 日 期 /时 间 进行 加 法 或 者 减法 运算 。 


例如 


如 果 传 递 给 参数 的 值 是 正 值 ,表示 时 间 向 后 推移 ; 如 果 是 负 值 , 则 表示 时 间 向 前 推移 。 
,AddMonths (2) 表示 两 个 月 之 后 的 日 期 ,AddMonths( 一 2) 则 表示 两 个 月 前 的 日 期 。 
【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 初始 化 一 个 日 期 /时 间 , 用 于 后 面 做 运算 测试 。 
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DateTime dl = new DateTime(2018, 4, 1); 


步骤 3: 计算 6 天 后 的 日 期 ,传递 给 AddDays 方法 参数 的 值 


DateTime d2 = dl. AddDays(6d); 


步骤 4: 计算 3 天 前 的 日 期 ,传递 给 AddDays 方法 参数 的 值 


图 5-10 日 期 加 /减法 
计算 结果 
DateTime d3 = di. AddDays( - 3d); 


步骤 5: 运行 应 用 程序 项 目 , 输 出 内 容 如 图 5-10 所 示 。 

实例 126 ”从 日 期 字符 串 中 产生 DateTime 实例 

【导语 】 

DateTime 结构 有 一 个 名 为 Parse 的 静态 方法 .该 方法 会 对 传人 的 字符 串 进行 分 析 , 如 
果 字 符 串 表示 的 是 有 效 的 日 期 /时 间 ,Parse 方法 会 返回 一 个 DateTime 实例 ,并 将 从 字符 串 
中 识别 出 来 的 数据 填充 到 该 DateTime 实例 中 ; 但 如 果 分 析 失 败 就 会 抽出 异常 。 若 希望 避 
免 抛 出 异常 ,可 以 使 用 TryParse 方法 ,该 方法 不 会 抽出 异常 .但 是 如 果 对 字符 串 的 分 析 失 败 
就 会 返回 false, 如 果 成 功 就 返回 true。 

用 于 进行 日 期 /时 间 分 析 的 字符 串 一 定 要 符合 标准 日 期 /时 间 格 式 的 要 求 ,可 以 在 
Windows 系统 的 日 期 和 时 间 设 置 中 获取 参考 信息 ,如 图 5-11 所 示 。 


在 任务 栏 中 显示 其 他 日 历 


格式 


一 周 的 第 一 天 : 
期 : 


图 S-11 Windows 系统 中 的 标准 日 期 与 时 间 格 式 
【操作 流程 】 
步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 字符 串 类 型 的 变量 并 初始 化 , 稍 后 将 用 它 分 析 日 期 /时 间 。 
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string ds = " 2018 年 5 月 20 日 23:14:20 "; 
步骤 3: 调用 Parse 方法 对 字符 串 进行 分 析 , 以 产生 新 的 DateTime 实例 。 
DateTime dt = DateTime.Parse(ds); 

步骤 4: 输出 新 产生 的 DateTime 实例 的 相关 属性 ,以 验证 字符 串 是 否 分 析 成 功 。 


string msg = $"{nameof(DateTime.Year), -10} = {dt.Year}\n" 
+ $"{nameof(DateTime.Month), -10} = {dt.Month}\n” 
+ $"{nameof(DateTime.Day), —10} = {dt.Day}\n"” 
+ $"{nameof(DateTime.Hour), -10} = {dt.Hour}\n" 
+ $"{nameof(DateTime.Minute), -10} = {dt.Minute}\n" 
+ $"{nameof(DateTime.Second), —10} = {dt.Second}"; 
Console. WriteLine(msg); 


步骤 5: 运行 应 用 程序 项 目 ,输出 结果 如 图 5-12 所 示 。 


图 5-12 从 字符 串 分 析出 来 的 日 期 与 时 间 


5.3 常用 的 字符 串 处 理 


实例 127 使 用 Concat 方 法 拼接 字符 串 


【导语 】 

String 类 公开 了 一 个 名 为 Concat 的 静态 方法 ,该 方法 的 作用 是 将 多 个 字符 串 拼接 成 一 
个 新 的 字符 串 实 例 。Concat 方法 是 直接 拼接 字符 串 的 ,此 过 程 中 不 会 使 用 任何 分 隔 符 。 例 
如 ,字符 串 “he” 与 字符 串 “llo”, 调 用 Concat 方法 拼接 后 将 返回 “hello”。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 3 个 string 类 型 的 变量 并 初始 化 。 


string sl = "abc"; 
string s2 = "def"; 
string s3 = "ghi"; 


步骤 3: 调用 Concat 方法 将 以 上 3 个 字符 串 实例 进行 拼接 。 


string sn = string.Concat(sl, s2, s3); 
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Console. WriteLine( sn); 


步骤 4: 运行 应 用 程序 项 目 ,Concat 方法 会 把 字符 串 直接 合并 ,输出 的 新 字符 串 实例 如 下 。 


abcdefghi 
实例 128 ”使 用 “十 ”运算 符 拼接 字符 串 
【导语 】 


对 于 数值 ,“ 十 "运算 符 表现 为 加 法 运算 ,而 对 于 字符 串 实例 , 则 可 用 于 拼接 ,其 效果 与 
Concat 方法 相同 ,也 是 直接 将 多 个 字符 串 实例 连接 起 来 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 4 个 string 类 型 的 变量 ,并 进行 赋值 。 


string a = "今天 "; 
string b = "的 天 气 "; 
string c = "很 "; 


string d = "晴朗 。"; 
步骤 3: 使 用 “十 ”运算 符 把 以 上 4 个 字符 串 实例 连接 起 来 。 
stringr =at+b+ct+td; 


步骤 4: 运行 应 用 程序 项 目 ,拼接 后 的 字符 串 如 下 。 


今天 的 天 气 很 晴朗 。 
实例 129 字符 串 的 包含 关系 
【导语 】 


Contains 方法 用 于 检查 某 个 字符 串 中 是 否 包 含 指定 的 子 字符 串 , 如 果 包 含 子 字符 串 , 则 
返回 true, 和 否则 返回 false。 

例如 ,字符 串 “ 百 川 东 到 海 " 中 如 果 包 含 子 字 符 串 “ 百 川 ”, 那 么 Contains 方法 就 返回 true。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 字符 串 变 量 ,并 进行 初始 化 , 稍 后 将 验证 在 该 字符 串 中 是 否 包含 单词 


need, 


string test = "I need peace with you"; 
步骤 3: 判断 以 上 字符 串 中 是 否 包 含 单词 need。 
bool b = test.Contains("need"); 


步骤 4: 将 验证 结果 输出 到 屏幕 上 。 


156 去 | .NET Core 实战 一 -手把手 教 你 掌握 380 个 精彩 案例 


Console. WriteLine(" 句 子 {0} 中 {1} 单 词 need。",， test, b? "包含 ”: "不 包含 "); 

步骤 5: 运行 应 用 程序 项 目 , 屏 幕 输出 的 内 容 如 下 。 

句子 I need peace with you 中 包含 单词 need。 

实例 130 ”字母 的 大 小 写 转 换 

【导语 】 

将 字符 串 中 的 字母 全 部 转换 为 大 写字 母 ,可 以 调用 ToUpper 方法 ; 若 需 要 全 部 转换 为 
小 写字 母 ,应 调用 ToLower 方法 。 
注意 : 这 两 个 方法 对 中 文字 符 无 效 。 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 字符 串 变 量 , 并 为 其 赋值 。 


string test = "I will be very hard to do it"; 

步骤 3: 将 字符 串 中 的 所 有 字母 全 部 转换 为 大 写 .并 输出 。 
Console. WriteLine( $ "全 部 转 为 大 写 :{test. ToUpper()}"); 

步骤 4: 将 字符 串 中 的 字母 全 部 转换 为 小 写 ,并 输出 。 
Console. WriteLine( $ "全 部 转 为 小 写 :{test. ToLower()}"); 


步骤 5: 按 下 F5 快捷 键 ,运行 应 用 程序 项 目 ,屏幕 输出 内 容 如 图 5-13 所 示 。 


CNprogram Files\dotnet\dotnet... = 0 x 


WILL BE D TO DO 
will 


图 5-13 ”字母 的 大 小 写 转换 


实例 131 使 用 分 隔 符 连接 字符 串 

【导语 】 

使 用 Concat 方法 或 者 "十 "运算 符 是 将 字符 串 直 接连 接 的 ,未 添加 任何 分 隔 的 字符 ,但 
是 在 有 些 情况 下 ,连接 字符 串 后 ,希望 每 个 子 串 之 间 都 有 一 个 分 隔 的 符号 。 例 如 ,将 十 六 进 
制 字符 串 (用 十 六 进 制 表示 字 节 ) 连 接 后 ,希望 每 字 节 之 间 都 用 一 个 "连接 。 假 设 有 3 个 字 
符 串 : 7E、9F、26 ,拼接 后 变 成 : 7E-9F-26。 

要 实现 在 连接 字符 串 的 同时 使 用 分 隔 符 , 可 以 调用 String 类 的 Join 方法 ,尽管 这 个 方 
法 有 多 个 重 载 版 本 ,不 过 用 法 一 样 。 第 一 个 参数 用 于 指定 分 隔 符 , 第 二 个 参数 是 要 进行 连接 
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的 字符 串 列 表 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 string 数组 ,并 使 用 几 个 字符 串 对 象 初始 化 。 稍 后 会 将 这 些 字符 串 元 
素 拼接 为 一 个 新 的 字符 串 实例 。 


string[ ] strs = { "abc"，"opq"，"uvw"，"xyz" }; 


步骤 3: 调用 Join 方 法 将 上 面 字符 串 数组 中 的 元 素 进行 拼接 ,分 隔 符 为 下 面 线 (_)。 


string outstr = string.Join('_', strs); 
步骤 4: 运行 应 用 程序 项 目 , 输 出 的 新 字符 串 实例 如 下 。 


abc_opq_uvw_xyz 


实例 132 ”查找 以 “ay” 结 尾 的 单词 

【导语 】 

String 类 有 一 对 方法 ,可 用 于 分 析 字 符 串 的 开头 与 结尾 部 分 。StartsWith 方法 可 用 于 
判断 当前 字符 串 是 否 以 某 个 字符 或 字符 串 开 头 ; 相应 地 .EndsWith 方法 可 用 于 分 析 当 前 字 
符 串 是 否 以 某 个 字符 或 字符 串 结尾 。 

这 两 个 方法 都 是 返回 布尔 类 型 的 值 : 若 结果 为 真 表 明 在 字符 串 的 开头 或 结尾 找到 了 需 
要 的 字符 ,否则 要 查找 的 字符 不 存在 。 例 如 ,用 StartWith 方法 在 字符 串 “then” 中 查找 
“th”, 方 法 调用 后 将 返回 true,; 因 为 单词 then 确实 是 以 th 开头 。 

本 实例 将 从 一 个 字符 串 数 组 中 查找 以 “ay?” 结 尾 的 字符 串 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 string 类 型 的 数组 ,用 于 稍 后 做 测试 。 


string[ ] test = { "day", "toy", "try", "pay", "they", "may" }; 


步骤 3: 使 用 foreach 循环 ,从 以 上 数组 中 找 出 以 ay” 结尾 的 元 素 ,并 输出 到 屏幕 上 。 


foreach(string s in test) 


{ 
if (s. EndsWith("ay")) 
. 


} 
} 


在 当前 字符 串 中 查找 是 否 以 某 个 字符 或 字符 串 结尾 ,应 
调用 EndsWith 方法 。 
步骤 4: 运行 应 用 程序 项 目 ,输出 结果 如 图 5-14 所 示 。 


Console. WriteLine(s); 


图 5-14 ”查找 以 “ay” 结 尾 的 单词 
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实例 133 ”依据 指定 的 分 隔 符 来 拆 分 字符 串 


【导语 】 

Split 方法 的 作用 与 Join 方法 相反 。Join 方法 是 以 指定 的 分 隔 符 来 连接 字符 串 , 而 
Split 方法 则 是 依据 指定 的 分 隔 符 来 拆 分 字符 串 。 

例如 ,字符 串 “A 十 B 十 C”, 指 定 分 隔 符 为 “十 ”, 于 是 将 拆 分 出 三 个 字符 串 实 例 一 一 A、B、 
C, 同 时 分 隔 符 “ 十 ”会 被 删除 , 即 返回 的 字符 中 是 不 包含 分 隔 符 的 。 因 为 拆 分 之 后 会 出 现 几 
段 宇 符 串 实例 ,所 以 Split 方法 的 返回 类 型 为 string 数组 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 string 类 型 的 变量 ,并 初始 化 。 


String test = "enlarge* a* picture"; 


步骤 3: 以 上 述 字符 串 中 的 “* ”字符 为 分 隔 符 ,对 字符 串 进行 拆 分 。 


string[ ] results = test. Split('* '); 
步骤 4: 输出 拆 分 后 的 字符 串 。 


foreach (string s in results) 


Console. Write(" {0}", s); 


} 


步骤 5: 运行 应 用 程序 项 目 ,应 用 程序 输出 的 内 容 如 图 5-15 皖 分 后 的 字符 中 
图 5-15 所 示 。 

实例 134 ”替换 字符 串 

【导语 】 

Replace 方 法 分 两 步 完 成 工作 ,首先 从 原来 的 字符 串 实例 中 查找 到 要 被 蔡 换 的 子 字符 
串 ,然后 再 用 新 的 子 字符 串 替换 掉 已 查找 到 的 子 字符 串 。 如 果 在 原 字 符 串 中 找 不 到 被 替换 
的 字符 串 ,那么 Replace 就 将 原 字符 串 返回 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 string 类 型 的 变量 ,并 进行 初始 化 。 

string str = "明天 去 买 一 台 洗 衣 机 "; 

步骤 3: 把 上 面 字符 串 中 的 “洗衣 机 "替换 为 " 电 冰 箱 ”。 

string res = str.Replace(" 洗 衣 机 "，" 电 冰箱 "); 
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步骤 4: 为 了 对 比 替换 前 后 的 效果 ,分 别 将 原 字符 串 与 替换 后 的 字符 串 输出 到 控制 台 。 
Console. WriteLine( $ " 原 字符 串 :{str}\n 替换 后 的 字符 串 :{res}") 
步骤 5: 运行 应 用 程序 项 目 ,得 到 如 图 5-16 所 示 的 结果 。 


图 5-16 替换 前 后 的 字符 串 对 比 


实例 135 反 转 字符 串 


【导语 】 

所 谓 反 转 字符 串 ,就 是 把 字符 串 中 所 有 字符 的 顺序 倒转 过 来 。 举 个 例子 ,假设 有 字符 串 
“编程 真 快乐 ”, 反 转 之 后 就 会 变 成 “ 乐 快 真 程 编 ”。 

char 类 型 表示 一 个 字符 ,而 字符 串 实 际 上 是 由 多 个 单字 符 组 成 的 ,所 以 字符 串 实 例 可 
以 先 提取 出 char 类 型 的 数组 对 象 , 然 后 再 调用 数组 对 象 的 Reverse 方法 将 里 面 的 char 元 素 
顺序 倒转 过 来 ,最 后 再 用 这 个 char 数组 重新 创建 字符 串 实例 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 一 个 ReverseString 方法 ,输入 参数 为 要 进行 反 转 的 字符 串 ,返回 内 容 为 已 
反 转 的 字符 串 。 


static string ReverseString( string input) 
{ 
char[ ] charr = input. ToCharArray(); 
Array. Reverse( charr); 
return new string(charr); 


注意 : Reverse 是 静态 方法 ,由 Array 类 公开 。 
String 与 string 指向 的 是 相同 的 类 型 。String( 首 字母 大 写 ) 是 . NET 中 的 类 型 , 即 
System. String 类 ,而 string( 小 写字 母 ) 是 语言 关键 字 , 实 际 上 也 指向 System. String 
类 。 因 此 ,在 代码 中 既 可 以 使 用 string, 也 可 以 使 用 String。 
类 似 的 情况 ,如 语言 关键 字 int, 实 际 上 指向 System. Int32 结构 ,在 代码 可 以 使 用 int 
关键 字 , 也 可 以 直接 用 Int32 结构 。 


步骤 3: 声明 一 个 string 类 型 的 变量 ,并 赋值 。 
string str = "一 行 白 览 上 青天 "， 
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步骤 4: 调用 前 面 定 义 的 ReverseString 方法 ,将 字符 串 进行 反 转 。 
string result = ReverseString(str); 


步骤 5: 为 了 能 直观 地 查看 效果 ,将 原 字符 串 与 反 
转 后 的 字符 串 都 输出 到 控制 台 。 


Console. WriteLine(" 原 字符 品 :{0}"，str); 
Console. WriteLine(" 反 转 后 的 字符 串 :{0}",， result); 


步骤 6: 运行 应 用 程序 项 目 ,输出 结果 如 图 5-17 


图 5-17 反 转 字符 串 


所 示 。 
实例 136 ”插入 与 删除 字符 
【导语 】 


Insert 方法 可 以 在 原 字符 串 的 指定 位 置 插 人 若干 字符 ,相对 应 地 ,Remove 方法 可 以 从 
原 字 符 串 中 删除 一 部 分 字符 。 

不 论 是 插入 字符 ,还 是 删除 字符 ,用 于 确定 操作 位 置 的 索引 都 是 基于 0 的 , 即 字 符 串 的 
开头 位 置 为 0, 结尾 的 位 置 为 字符 串 长 度 减 去 1。 例 如 ,要 在 某 个 字符 串 的 第 3 个 字符 处 插 
和 内容 ,那么 其 位 置 索引 就 是 2 。 

本 实例 先 演示 Insert 方法 的 使 用 ,后 演示 Remove 方 法 的 使 用 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 string 类 型 的 变量 ,并 初始 化 。 


string test = "明天 吃饭 "; 


步骤 3: 在 上 面 字 符 串 的 “明天 ”后 面 插入 字符 串 “ 中 午 ”, 插 入 位 置 为 第 3 个 字符 处 , 索 
引 为 2。 


test = test. Insert(2, "中 午 "); 

插入 后 返回 新 的 字符 串 实例 ,此 时 字符 串 变 为 “明天 中 午 吃 饭 ”。 

步骤 4: 在 “中 午 ” 后 面 插入 “出 去 ”, 插 入 位 置 为 第 5 个 字符 处 ,索引 为 4。 

test = test. Insert(4, "出 去 "); 

此 时 返回 的 新 字符 串 实例 为 “明天 中 午 出 去 吃饭 ”。 

步骤 5: 再 向 test 变量 赋值 一 个 新 的 字符 串 实 例 。 

test = "小 桥 公 路 流水 人 家 "; 

步骤 6: 需要 将 上 述 字 符 串 中 的 “公路 ”删除 ,可 调用 Remove 方法 ,开始 位 置 为 第 3 个 
字符 ,索引 为 2, 删除 字符 数 为 2。 
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test = test.Remove(2, 2); 
执行 Remove 方法 后 ,将 返回 新 的 字符 串 实例 , 原 字符 串 变 为 “小 桥 流 水 人 家 ”。 
实例 137 ”填充 剩余 “空白 ” 


【导语 】 

String 类 公开 了 两 个 方法 ,支持 用 指定 的 字符 来 填充 原 字 符 串 中 的 剩余 空间 。PadLeft 
方法 将 原 字符 串 右 对 齐 , 并 在 左边 填充 ; 相反 地 ,PadRight 方法 则 将 原 字 符 串 左 对 齐 ,并 在 
右边 填充 。 这 两 个 方法 各 有 两 个 重 载 。 

String PadLeft( :int totalWidth); 

String PadLeft( int totalWidth, char paddingChar); 

String PadRight (int totalWidth); 

String PadRight(int totalWidth, char paddingChar); 

totalWidth 指定 填充 后 新 字符 串 实例 的 长 度 , 如 果 原 字符 串 长 度 为 6, 而 totalWidth 参 
数 指定 为 10, 那 么 新 字符 串 中 会 包含 原 字符 串 和 4 个 填充 的 字符 。paddingChar 参数 表示 
用 来 填充 的 字符 ,如 果 不 指定 paddingChar 参数 , 则 默认 使 用 空格 来 填充 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Main 方法 中 ,使 用 PadRight 方法 对 示例 字符 串 进 行 右 侧 填充 。 


Console. WriteLine("abcd". PadRight (20, '*"')); 

Console. WriteLine("abcdef". PadRight (20, '* ")); 
Console. WriteLine( "abcdefgh".PadRight(20, '*")); 
Console. WriteLine("abcdefghijklmn". PadRight(20, '@')); 


步骤 3: 使 用 PadLeft 方 法 对 示例 字符 串 进 行 左 侧 填 充 。 


Console. WriteLine("opq". PadLeft(16, '+"')); 
Console. WriteLine("opqrst". PadLeft(16, '#")); 


步骤 4: 运行 应 用 程序 项 目 ,屏幕 输出 结果 如 图 5-18 所 示 。 ”图 s-18 填充 后 的 字符 串 

实例 138 ”判断 字符 是 否 为 数字 

【导语 】 

char 结构 有 两 个 方法 可 以 用 于 检测 某 个 字符 是 否 为 数字 。 

IsDigit 方法 仅 能 用 于 判断 标准 的 十 进 制 数字 字符 , 即 从 0 到 9, 共 10 个 字符 。 而 
IsNumber 方法 的 适用 面 更 广 ,不 仅 可 用 于 判断 标准 十 进 制 数 字 字 符 , 它 还 可 用 于 判断 其 他 
Unicode 数字 字符 ,例如 ,“@* 也 ”jy 1/2” 等 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
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步骤 2: 声明 一 个 char 类 型 数组 ,用 于 初始 化 的 字符 串 ,其 中 混 有 数字 字符 与 非 数字 字 
符 , 用 于 稍 后 进行 判断 处 理 。 


char[] charr = { 3 f', '®', '#', a 的 ve '#'}; 


步骤 3: 调用 IsNumber 方法 对 数组 中 的 字符 进行 判断 。 


foreach(char c in charr) 
{ 
Console. WriteLine("{0} {1} 数 字 "，c，char.IsNumber(c) ? 
"是 " : "不 是 ") 
本 


步骤 4: 运行 应 用 程序 项 目 , 输 出 结果 如 图 5-19 所 示 。 

实例 139 ”截取 字符 串 

【导语 】 

截取 字符 串 ,就 是 从 原 字 符 串 实例 中 取出 部 分 内 容 , 并 产生 新 的 字符 串 实例 。 例 如 , 字 
符 串 "abcdefghijiklmn”, 假 设 从 第 3 个 字符 开始 ,截取 4 个 字符 ,那么 得 到 的 新 字符 串 ( 或 称 
为 子 串 ) 就 是 “cdef”。 

截取 字符 串 的 功能 由 Substring 方法 实现 , 它 有 两 个 重 载 版 本 。 


图 5-19 判断 是 否 为 数字 字符 


String Substring(int startIndex); 

String Substring( int startIndex, int length); 

如 果 不 指定 length 参数 (要 截取 字符 的 个 数 ) , 则 从 startIndex 参数 所 指定 的 位 置 开 始 ， 
- 直 截 取 到 字符 串 的 末尾 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 做 测试 的 string 类 型 变量 ,并 赋 初 始 值 。 


string s = "从 此 地 出 发 ,大 约 需要 二 十 分 钟 "; 
步骤 3: 从 第 7 个 字符 开始 ,截取 7 个 字符 。 


string sub = s.Substring(6, 7); 


startIndex 参数 所 指定 的 位 置 索引 是 从 0 开始 计算 的 ,第 7 个 字符 的 位 置 应 为 6。 
步骤 4: 同时 输出 截取 前 后 的 字符 串 实例 ,以 方便 对 比 。 


Console. WriteLine("{0} -> {1}", s, sub); 
步骤 5: 运行 应 用 程序 项 目 ,输出 内 容 如 下 。 
从 此 地 出 发 ,大 约 需要 二 十 分 钟 -> 大 约 需 要 二 十 分 
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实例 140 ”使 用 StringBuilder 组 装 字符 串 


【导语 】 

StringBuilder 类 为 字符 串 的 组 装 提供 了 比较 综合 的 功能 ,覆盖 了 字符 串 的 各 种 操作 。 
主要 有 : 

(1) 追加 。 追 加 就 是 在 现 有 字符 串 的 末尾 拼接 内 容 。 有 四 个 与 追加 操作 相关 的 方法 : 
Append 方法 是 直接 把 内 容 追 加 到 字符 串 末 尾 , 不 带 换行 符 ; AppendLine 方法 追加 字符 串 
后 会 自动 在 末尾 加 上 换行 符 (\n); AppendFormat 方法 在 追加 字符 串 时 支持 使 用 格式 化 字 
符 串 ; AppendJoin 方法 与 string. Join 方法 相似 , 先 将 各 个 部 件 通过 分 隔 符 串联 起 来 ,再 追 
加 到 原 字符 串 末 尾 。 

(2) 捅 人 与 删除 。Insert 方法 可 以 在 原 字 符 串 的 某 个 位 置 插入 新 内 容 , 它 与 追加 不 同 ， 
追加 只 能 把 新 内 容 拼接 到 原 字符 串 的 末尾 ,而 Insert 方法 则 可 以 在 任意 有 效 位 置 写 入 新 内 
容 。 要 从 指定 位 置 删除 若干 字符 ,可 以 使 用 Remove 方法 。 

(3) 蔡 换 。 调 用 Replace -方法 ,可 以 将 原 字符 串 的 指定 内 容 蔡 换 为 新 的 内 容 。 

(4) 清除 。 调 用 Clear 方法 将 删除 StringBuilder 实例 已 缓存 的 所 有 字符 。 

当 字 符 串 组 装 完成 ,可 调用 StringBuilder 实例 的 ToString 方法 返回 已 组 装 好 的 字符 串 
实例 CString 类 型 ) 。 

有 意思 的 是 ,StringBuilder 类 有 很 多 方法 的 返回 类 型 也 是 StringBuilder, 也 就 是 说 , 当 
调用 某 个 方法 完成 某 项 处 理 后 ,StringBuilder 对 象 会 把 自身 返回 给 调用 方 。 这 种 设计 模型 
的 好 处 是 可 以 连续 调用 一 个 对 象 实例 的 多 个 方法 。 例 如 以 下 形式 。 


builder. AppendLine(*…) 
.Rppend(… ) 
:RARppend(…) 
:Rppend(… ) 
【操作 流程 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 引入 System. Text 命名 空间 。 


using System. Text; 

步骤 3: 实例 化 StringBuilder 对 象 。 
StringBuilder builder = new StringBuilder(); 
步骤 4: 向 builder 变量 中 添加 内 容 。 


builder. AppendLine("Happy !") 
. Append( "abc") 
.Append("—") 
. Append( "xyz\n") 
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.AppendFormat ("Ox{0:x} = {0}\n", 144650) 
. AppendJoin( '~', 50, false, 3.6625d) 
. AppendLine( ) 
. Replace( "Happy", "Hello Jim"); 
以 上 代码 对 builder 变量 采取 实例 方法 的 连续 调用 ,分 别 进行 了 以 下 处 理 : 
(1) 添加 一 行 *“Happy !”。 
(2) 添加 字符 串 “abe”, 无 换行 符 。 
(3) 添加 字符 “-”, 无 换行 符 。 
(4) 添加 字符 串 “xyz”, 后 跟 换 行 符 “\n”。 
(5) 通过 格式 化 标志 添加 整数 值 144650,“ 二 ”左边 是 十 六 进 制 表示 方式 (使 用 x 格式 标 


志 , 表 示 十 六 进 制 )，“= ”右边 是 整数 的 默认 表示 方式 (十 进 制 ) 。 


(6) 用 字符 “一 ”将 整数 值 50、 布 尔 值 false、 双 精度 小 数 3. 6625 连接 起 来 ,再 追加 到 


StringBuilder 实例 中 。 


的 内 容 输出 到 屏幕 。 


(7) 追加 一 个 空白 行 (调用 无 参数 的 AppendLine 方法 ) 。 
(8) 将 前 面 添加 的 “Happy” 字 符 串 替换 为 "Hello Jim”。 
步骤 $: 调用 Console. WriteLine 方法 将 StringBuilder 中 


Console. WriteLine(builder); 


WriteLine 方法 会 自动 调用 builder 变量 的 ToString 方法 。 


步骤 6: 运行 应 用 程序 项 目 , 屏 幕 输出 如 图 5-20 所 示 。 5-20 StringBuilder 对 象 
实例 141 “字符 串 查 找 提交 后 的 字 有 有 昌 
【导语 】 


字符 串 查找 的 结果 是 返回 被 找到 字符 串 所 在 的 位 置 , 如 果 没 有 找到 要 查找 的 字符 串 , 那 


么 就 返回 一 1。 


IndexOf 方法 与 LastIndexOf 方法 的 作用 正好 是 相对 的 。 如 果 要 查找 的 字符 串 在 原 字 


符 串 中 出 现 多 次 ,那么 IndexOf 方法 返回 字符 串 第 一 次 出 现时 的 位 置 , 而 LastIndexOf 方法 
则 是 返回 字符 串 最 后 一 次 出 现时 的 位 置 。 


封 


【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 string 类 型 的 变量 ,并 进行 初始 赋值 。 

string test = "明日 复明 日 ,明日 何其 多 "; 

步骤 3: 上 述 字 符 串 变量 中 ,出 现 了 三 个 “明日 ”, 下 面 代码 分 别 找 出 “明日 "第 一 次 和 最 


-次 出 现 的 位 置 。 


int first = test. IndexOf(" 明 日 "); 
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int last = test.LastIindexOf(" 明 日 "); 
步骤 4: 在 控制 台中 输出 相关 信息 。 


Console. WriteLine(" 明 日 "在 "{0}" 中 第 一 次 出 现 的 位 置 是 :{1}, 
最 后 一 次 出 现 的 位 置 是 :{2}。"，test, first, last); 


步骤 5: 运行 应 用 程序 项 目 , 输 出 结果 如 图 5-21 所 示 。 图 5-21 查找 字符 串 的 位 置 
实例 142 ”比较 字符 串 时 忽略 大 小 写 


【导语 】 
String 类 的 Compare 方法 有 以 下 重 载 版 本 。 


static int Compare(String strA, String strB，bool ignoreCase); 


方法 对 两 个 字符 串 对 象 (strA 与 strB) 进 行 比较 ,如 果 两 者 相同 ,Compare 方法 返回 0; 
如 果 返 回 非 0 值 ,表示 两 个 字符 串 对 象 并 不 相同 。 当 返回 值 大 于 0 时 ,表示 strA 在 字符 排 
序 上 要 比 strB 更 靠 后 ,反之 则 更 靠 前 。 例 如 ,strA 为 “abc”,strB 为 “xyz”, 那 么 , 相 比 较 后 ， 
返回 值 为 一 1, 因 为 "abc" 在 字符 中 的 排序 更 靠 前 。 

字符 排序 一 般 有 这 几 种 依据 : 数字 顺序 .字母 顺序 .中 文 拼音 顺序 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 两 个 string 类 型 的 变量 ,并 进行 初始 化 。 


string sl 


string s2 
步骤 3: 对 上 面 两 个 字符 串 进行 比较 。 

int rc = string.Compare(sl, s2, true); 

步骤 4: 输出 比较 结果 。 

Console.Write( $ "忽略 大 小 写 差异 后 , {s1} 与 {s2} "); 


if (rc == 0) 
Console. Write(" 相 等 "); 

li 图 5-22 忽略 大 小 写 后 
Console. Write(" 不 相等 "); 两 字符 串 相等 


步骤 5: 运行 应 用 程序 项 目 ,输出 结果 如 图 5-22 所 示 。 
实例 143 “@” 符 号 在 字符 串 中 的 用 途 


【导语 】 
在 字符 串 常 量 前 面 加 上 一 个 "@” 符 号 ,表示 将 忽略 字符 串 中 的 转 义 字符 ,如 ”An Nt” 
“\r” 等 ,尤其 是 在 输入 文件 路 径 的 时 候 该 符号 特别 有 用 。 
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例如 ,在 不 使 用 *@” 答 号 时 ,文件 路 径 需 要 这 样 处 理 ; 
"\\folder1\\folder2\\test. pptx" 
于 “\" 是 转 义 字符 的 开始 标志 ,因此 如 果 在 文本 中 出 现 该 字符 ,就 必须 写成 “\”。 而 在 使 
日 了 “@” 符 号 之 后 , 转 义 字符 被 忽略 ,就 可 以 直接 使 用 原 义 字 符 。 
@"\folderl\folder2\test. pptx" 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 string 类 型 的 变量 ,并 为 其 赋值 。 
string s = @" 文 本 一 \n 文 本 二 \t 文 本 三 "; 
步骤 3: 将 字符 串 输出 到 屏幕 。 


spp 


Console. WriteLine(s); 

步骤 4: 运行 应 用 程序 项 目 ,控制 台 窗 口 将 输出 以 下 内 容 。 

文本 一 \n 文 本 二 \t 文 本 三 

因为 “@” 符 号 忽略 了 所 有 的 转 义 字符 ,所 以 ,“\n” 和 “\t" 不 会 被 视 为 换行 符 和 制 表 符 ， 


而 仅仅 作为 普通 字符 输出 。 

实例 144 ”处 理 字符 串 中 出 现 的 双 引 号 

【导语 】 

由 于 字符 串 常量 本 身 需 要 放 在 一 对 双 引 号 中 ,因此 ,如 果 字 符 串 中 出 现 双 引号 , 那 就 得 
进行 特殊 处 理 。 

如 果 字 符 串 常量 没有 使 用 “@* 符 号 ,可 以 通过 转 义 的 方式 解析 字符 串 中 的 双 引 号 ,形式 
如 下 : 


"the output content is \"data updated\"" 


如 果 字 符 串 常量 使 用 了 “@”, 此 时 转 义 失效 ,需要 在 字符 串 中 出 现 的 双 引 号 可 以 用 连续 
两 个 双 引 号 表示 。 


@"run ""cmd"™"" 


【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 string 类 型 变量 并 赋值 ,在 字符 串 常 量 中 使 用 转 义 字符 插入 双 引 号 ,随后 
将 其 输出 。 


string sl = "type in \"dir\"™"; 
Console. WriteLine( s1); 
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步骤 3: 在 带 “@” 符 号 的 字符 串 中 ,通过 连续 输入 两 个 双 引号 的 方式 插入 双 引 号 。 并 将 
字符 串 输出 。 


string s2 = @"execute the ""dotnet new"" comnand"; 
Console. WriteLine(s2); 


步骤 4: 运行 应 用 程序 项 目 后 ,控制 台 窗 口 输出 以 下 文本 。 


type in "dir" 
execute the "dotnet new" command 


注意 : 如 果 字 符 串 中 包含 中 文 的 双 引 号 ,不 需 做 任何 处 理 。 因 为 中 文 的 标点 符号 不 会 干扰 
代码 编译 。 


5.4 格式 控制 符 


实例 145 输出 百分比 


【导语 】 

百分比 的 格式 控制 符 为 *P” 或 “p”, 使 用 该 格式 控制 符 ,可 以 将 普通 数值 输出 为 百分比 
形式 ,也 就 是 将 原 数值 乘 以 100 并 在 后 面 接 上 “%” 符 号 。 

在 格式 控制 符 后 面 紧 跟 一 个 整数 ,可 以 指定 要 保留 的 小 数位 数 。 例 如 ,“P3” 表 示 将 原 
数值 输出 为 百分比 形式 ,并 保留 3 位 小 数 。 

举 个 例子 , 浮 点 数 0. 003 ,使 用 *P? 格 式 控制 符 后 ,输出 的 字符 串 为 "0. 30%”。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 并 初始 化 一 个 单 精 度 浮 点 数值 。 


float val = 0.1785f; 


步骤 3: 使 用 “P” 格 式 控制 符 输出 以 上 数值 的 百分比 形式 ,默认 情况 下 ,“P” 格 式 控制 符 
将 保留 2 位 小 数 。 
Console. WriteLine( $ "{"p", — 15} {val, ~ 10:p}"); 


步骤 4: 使 用 *P3” 格 式 控制 符 输出 百分比 形式 ,而 且 保 
留 3 位 小 数 。 


Console. WriteLine( $ "{"p3", — 15}{val, — 10:p3}"); 
步骤 5: 按 下 F5 快捷 键 运行 应 用 程序 项 目 , 控 制 台 的 : 
输出 如 图 5-23 所 示 。 图 5-23 输出 百分比 格式 文本 
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实例 146 输出 当前 语言 中 的 货币 格式 

【导语 】 

使 用 “C” 或 “c” 格 式 控 制 符 所 输出 的 文本 ,会 在 文本 前 面 加 上 一 个 货币 符号 。 该 格式 控 
制 符 是 根据 当前 系统 所 使 用 的 区 域 与 语言 属性 来 确定 货币 符号 的 ,例如 人民 币 将 使 用 * 竺 ” 
符号 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 直接 使 用 “ce” 格式 控制 符 输 出 数值 ,默认 保留 2 位 小 数 。 

WriteLine("{0:c}", 20.5); 

输出 结果 如 下 。 

¥20.50 

步骤 3: 输出 货币 格式 ,并 保留 1 位 小 数 。 

WriteLine("{0:c1}", 150.39); 

输出 结果 将 小 数 部 分 的 0. 39 四 舍 五 入, 变 为 如 下 形式 。 

¥150.4 

步骤 4: 输出 货币 格式 , 仅 保留 整数 部 分 。 

WriteLine("{0:c0}", 83.71); 

输出 时 将 去 掉 小 数 部 分 ,结果 如 下 。 


¥84 


实例 147 输出 多 个 币 种 格式 


【导语 】 
许多 数值 类 型 (如 double、decimal 等 ) 都 公开 一 个 特殊 的 ToString 方法 重 载 。 


string ToString(string format, IFormatProvider provider); 


format 参数 指定 格式 控制 符 ,provider 是 一 个 接口 ,其 中 一 个 实现 类 是 位 于 System. 
Globalization 命名 空间 下 的 CultureInfo。CultureInfo 类 封装 了 与 各 地 区 的 语言 与 文化 信 
息 相 关 的 数据 。 

获取 CultureInfo 实例 有 多 种 方法 ,例如 可 以 通过 调用 构造 函数 进行 实例 化 ,并 向 构造 函数 传 
递 区 域 /语言 名 称 或 标识 ID; 还 可 以 通过 GetCultureInfo .GetCultureInfoByIetLanguageTag 等 静 
态 方法 来 直接 获得 CultureInfo 实例 。 
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除了 ToString 方法 ,还 可 以 使 用 String 类 的 Format 方法 、StringBuilder 类 的 


AppendFormat 方法 来 输出 由 IFormatProvider 修饰 的 格式 化 字符 串 。 


直 


本 实例 将 演示 ToString 方法 结合 CultureInfo 来 输出 不 同 货币 的 文本 表示 形式 。 


【操作 流程 】 
步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 


步骤 2: 声明 一 个 变量 并 赋 一 个 十 进 制 数值 ,用 于 稍 后 做 测试 。 


decinmal val = 3960.12M; 


步骤 3: 获取 6 个 CultureInfo 实例 ,分 别 表 示 中 国 大 陆 `. 中 国 台湾 美国 .中 国 香港 .中 


澳门 日本。 


CultureInfo cn = CultureInfo. GetCultureInfoBYIetfLanguageTag("zh 一 CN" )/ 
CultureInfo tw = CultureInfo. GetCultureInfoByIetfLanguageTag("zh 一 TW"); 
CultureInfo us = CultureInfo. GetCultureInfoBYIetfLanguageTag("en - US"); 
CultureInfo mo = CultureInfo. GetCultureInfoBYIetfLanguageTag("zh 一 MO" ); 
CultureInfo hk = CultureInfo. GetCultureInfoBYIetfLanguageTag("zh 一 HK"); 
CultureInfo jp = CultureInfo.GetCultureInfoByIetfLanguageTag("ja— JP"); 


步骤 4: 根据 上 面 获取 的 6 个 区 域 信息 ,输出 不 同 的 货币 


格式 。 


Console. WriteLine(" 原 数值 :{0}\n",， val); 


Console.WriteLine(" 人 民 币 :{0}", val. ToString("C", cn)); 
Console. NriteLine( "台币:{0}", val. Tostring("C", 
Console. WriteLine(" 美 元 :{0}", val. ToString("C", 
Console. WriteLine(" 澳 元 :{0}", val. ToString("C", 
Console. WriteLine( "港币 :{0}",， val. ToString("C", 
Console. WriteLine(" 日 元 :{0}", val. ToString("C", 


步骤 5: 运行 应 用 程序 项 目 ,屏幕 输出 内 容 如 图 5-24 所 示 。 
实例 148 ”数字 的 两 种 常用 格式 


【导语 】 


tw) ); 
ns)); 
mo) ) 7 
hk)); 
jp)); 


图 5-24 输出 多 种 货币 格式 


数字 一 般 有 两 种 表示 格式 : 一 种 是 直接 表示 (格式 控制 符 为 G), 例 如 12345678. 6665; 


还 有 一 种 也 比较 常见 , 即 每 隔 3 位 就 用 


12,345,678.22。 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 decimal 变量 并 赋值 。 


decimal d = 8582113.76352M; 


-个 英文 的 逗号 标注 (格式 控制 符 为 N), 例 如 


“M” 是 一 个 类 型 后 级 ,在 数值 后 面 加 上 “M” 或 “m”, 表 示 一 个 decimal 类 型 的 数值 ,就 像 
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可 以 在 双 精 度数 值 后 面 加 上 “d” 一 样 。 

步骤 3: 分 别 以 “G” 和 “N” 格 式 输 出 数值 的 字符 串 形式 。 

Console. WriteLine("{0, -15}{1, — 20:G}", "G",d); 

Console. WriteLine("{0, -15}{1, — 20:N}", "N", d); 

在 Console. WriteLine 方法 或 者 String. Format 方法 中 ,格式 占 位 符 用 一 对 大 括号 括 着 
的 整数 值 表示 ,从 0 开始 计算 。 在 格式 占 位 符 中 ,以 逗号 
(英文 ) 开 头 表示 被 格式 化 文本 的 对 齐 方式 , 正 数 值 表示 
右 对 齐 , 负 数值 表示 左 对 齐 , 数 字 表示 所 占用 的 字符 数 ， 
如 果 格 式 化 输出 的 内 容 小 于 该 长 度 , 则 用 空格 填充 剩余 
空间 。 以 冒号 (英文 ) 开 头 表 示 要 使 用 的 格式 控制 符 , 例 
如 本 例 中 用 到 的 “G” 和 *N”。 

步骤 4: 按 下 快捷 键 F5 运行 应 用 程序 项 目 ,输出 结 
果 如 图 5-25 所 示 。 

实例 149 ”使 用 字符 串 内 插 

【导语 】 

在 早期 的 版 本 中 ,要 对 字符 串 进 行 格式 化 输出 ,一 般 需 要 借助 String 类 的 Format 方 
法 ,或 者 Console、TextWriter,StringBuilder 等 类 所 公开 的 相关 方法 。 但 是 这 些 方法 都 需要 
安排 从 0 开始 计算 的 格式 占 位 符 ,操作 起 来 也 不 太 简 便 。 

而 使 用 字符 串 内 插 , 就 可 以 直接 在 初始 化 字符 串 实例 时 插入 格式 控制 。 而 且 字 符 内 插 
并 不 需要 基于 0 的 有 序 格式 占 位 符 , 在 一 对 大 括号 内 直接 写 上 表达 式 即 可 。 

例如 ,要 输出 字符 串 * 圆 周 率 王 XXX?” ,其 中 ,XXX 是 通过 Math. PI 常量 返回 的 。 此 时 
可 以 用 内 插 字 符 串 。 

string v = $ "圆周 率 = {Math.PI}"; 

在 运行 阶段 ,生成 的 字符 串 如 下 。 

圆周 率 = 3.14159265358979 

字符 串 内 插 的 标志 是 字符 串 常 量 前 要 加 上 “$ ”符号 ,否则 编译 器 仅 将 其 视 为 普通 字符 
串 , 内 捕 的 表达 式 不 会 被 计算 
字符 串 内 搬 还 可 以 对 格式 设置 进行 补充 。 在 表达 式 之 后 ,用 逗号 (半角 ) 开 头 表示 字符 
的 对 齐 方式 , 负 值 表示 左 对 齐 , 正 值 表示 右 对 齐 ;， 随后 以 冒号 (半角 ) 开 头 表示 格式 控制 符 。 
完整 的 格式 如 下 。 

{< 表达 式 >, < 对 齐 方式 >:< 格 式 控制 符 >} 


【操作 流程 】 
步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 


图 5-25 输出 常见 的 数字 格式 
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步骤 2: 声明 两 个 int 类 型 的 变量 并 初始 化 。 


int m = 100; 
intn = 250; 


步骤 3: 使 用 字符 串 内 插 ,输出 形 如 “A 十 B = C” 的 字符 串 。 


Console. WriteLine( $ "{n} + {n} = {m + n}"); 


步骤 4: 声明 一 个 double 类 型 的 变量 r, 它 表示 一 个 圆 的 半径 。 
double rt = 7.325d; 


步骤 5: 通过 字符 串 内 插 ,输出 圆 的 面积 ,并 且 保 留 2 位 小 数 。 


Console. WriteLine( $ "半径 为 {r} 的 圆 的 面积 为 : {Math.PI * r x r:N2}"); 
在 表达 式 之 后 紧 跟 ": N2”, 表 示 输 出 的 值 为 常规 数字 ,“2” 表 示 保 留 2 位 小 数 。 
步骤 6: 运行 应 用 程序 项 目 ,输出 结果 如 下 ， 


100 + 450 = 550 
半径 为 7.325 的 圆 的 面积 为 :168. 56 


实例 150 ”长 日 期 与 短 日 期 

【导语 】 

标准 日 期 格式 用 得 比较 多 的 是 长 日 期 和 短 日 期 ,具体 的 显示 方式 取决 于 系统 的 设置 (如 
图 5-26 所 示 )。 


命 更 改 日 期 和 时 间 格 式 


短 时 间 格 式 
H:mm 
长 时 间 格式 


H:mm:ss ~ 


图 5-26 ”Windows 系统 中 关于 日 期 格式 的 设置 
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调用 DateTime 实例 的 ToLongDateString 方法 可 以 直接 返回 长 日 期 字符 串 , 同 样 , 调 


用 ToShortDateString 方法 可 以 返回 短 日 期 字符 串 。 不 过 本 实例 主要 演示 通过 格式 控制 符 


来 返 


可 长 日 期 和 短 日 期 字符 串 。 


长 日 期 的 格式 控制 符 为 *“D”, 短 日 期 的 格式 控制 符 则 为 “d”。 
【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 。 

步骤 2: 初始 化 一 个 DateTime 对 象 , 稍 后 用 于 测试 。 


DateTime dt = new DateTime(2018, 5, 1); 
步骤 3: 使 用 *“D” 和 “d” 格 式 控制 符 分 别 输出 上 述 日 期 的 长 日 期 和 短 日 期 形式 。 


Console. WriteLine( $ "长 日 期 :{dt:D}"); 
Console. WriteLine( $ " 短 日 期 :{dt:d}"); 


步骤 4: 运行 应 用 程序 项 目 ,控制 台 输 出 内 容 如 下 。 
长 日 期 :2018 年 5 月 1 日 

得 日 期 :2018-5-1 

实例 151 自 定义 日 期 和 时 间 格 式 


【导语 】 
对 于 日 期 和 时 间 值 , 最 常用 到 的 有 年 、 月 \ 日 \ 时 、 分 、 秒 ,其 中 每 一 部 分 都 有 对 应 的 格式 


控制 符 。 


(1) 年 。 一 般 使 用 “yyyy” 表 示 , 即 4 位 整数 ,如 2015。 也 可 以 使 用 控制 符 "yy”, 使 用 2 


位 整数 表示 ,如 2018 年 ,输出 为 18。 


(2) 月 。“M” 表 示 从 1 到 12,“MM” 表 示 从 01 到 12。 
(3) 日 。“d” 表 示 从 1 到 31,“dd” 表 示 从 01 到 31。 
(4) 时 。“h” 表 示 从 1 到 12,“hh” 表 示 从 00 到 12。 如 果 需 要 24 小 时 表示 方式 ,就 要 用 


大 写 的 H, 即 “H” 表 示 从 0 到 23,“HH” 表 示 00 到 23。 


10: 


(5) 分 。“m” 表 示 从 0 到 59,“mm” 表 示 从 00 到 59。 

(6) 秒 。“s” 表 示 从 0 到 59,“ss” 表 示 从 00 到 59。 

例如 ,要 输出 形 如 “2017-6-3” 的 格式 ,格式 控制 符 为 “yyyy-M-d”; 要 输出 “2017-6-3 15: 
20”, 则 格式 控制 符 为 “yyyy-M-d HH: mm: ss”。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 DateTime 类 型 的 变量 ,并 进行 初始 化 。 


DateTime dt = new DateTime(2018, 2, 1, 16, 37, 11); 
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步骤 3: 使 用 自 定义 的 格式 控制 符 , 调 用 ToString 方法 返回 自 定义 的 日 期 /时 间 表 示 方 式 。 
Console. WriteLine( $" 自 定义 日 期 /时 间 格 式 :{dt. ToString("yyyy 一 M-d,HH:mm:ss")}"); 

步骤 4: 运行 应 用 程序 项 目 ,控制 台 输 出 内 容 如 下 。 

自 定义 日 期 /时 间 格 式 :2018 -2 一 1,16:37:11 


实例 152” 自 定义 小 数位 数 


【导语 】 
“# "与 “0 格式 控制 符 的 作用 相同 ,都 是 用 来 自 定义 数字 格式 的 。 但 是 两 个 格式 控制 符 
之 间 略 有 不 同 。 


“ 井 ?” 仅 填充 有 效 位 ,如果 某 数位 上 是 0 并 且 不 是 必需 的 ,那么 就 会 被 忽略 。 例 如 0. 2， 
使 用 “并 . # 并 ”格式 控制 符 后 就 会 输出 “. 2” ,整数 部 分 的 0 会 被 忽略 ,小 数 部 分 虽然 有 2 位 ， 
但 只 有 “2” 才 是 有 效 位 。 

同样 以 0. 2 为 例 ,对 于 “0” 格 式 控制 符 ,“0.00” 就 会 输出 0. 20”"。 因 为 “0” 格 式 控制 符 对 
于 非 有 效 位 都 用 “0” 来 填充 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 double 类 型 的 变量 并 进行 赋值 。 


double d = 572.562170932d; 

步骤 3: 将 上 面 变 量 的 值 转 为 字符 串 输 出 ,分 别 保 留 5 位 小 数 、3 位 小 数 、1 位 小 数 ,以 及 
仅 保留 整数 位 。 

Console.WriteLine(" 保 留 5 位 小 数 :{0}"，d.ToString("0.00000")); 

Console.WriteLine(" 保 留 3 位 小 数 :{0}"，d.ToString("0.000") ); 


Console. WriteLine(" 保 留 1 位 小 数 :{0}"，d.ToString("0.0"))7 
Console.WriteLine(" 保 留 整数 :{0}"，d.ToString("#")); 


步骤 4: 运行 应 用 程序 项 目 , 控 制 台 输 出 内 容 如 图 5-27 所 示 。 


图 5-27 保留 小 数位 
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5.5 从 字符 串 到 其 他 类 型 的 转换 


实例 153 ”从 二 进 制 字符 串 产 生 int 实例 


【导语 】 

Convert 类 公开 了 一 组 方法 ,支持 将 整数 字符 串 转换 为 整数 类 型 ,这 些 方法 包括 : 
byte ToByte( string value, int fromBase); 

short ToInt16(string value int fromBase); 

static int ToInt32(string value, int fromBase); 

long ToInt64( string value, int fronBase); 

sbyte ToSByte( string value, int fromBase); 

ushort ToUInt16(string value, int fromBase); 

uint ToUInt32(string value, int fromBase); 

ulong ToUInt64( string value, int fromBase); 


这 些 方法 部 有 一 个 共同 的 参数 一 一 fromBase。 此 参数 用 于 指定 value 参数 属于 什么 进 
制 的 字符 串 。 如 果 字 符 串 表示 的 是 十 六 进 制 的 数值 ,那么 fromBase 参数 的 值 为 16。 

本 实例 演示 的 是 将 二 进 制 字符 串 转换 为 32 位 整数 值 。 其 他 整数 类 型 只 需要 调用 相对 
应 的 方法 即 可 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 字符 串 变 量 ,并 赋值 一 个 二 进 制 数值 。 


string str = "1011101001"; 
步骤 3: 调用 Convert. ToInt32 方法 将 二 进 制 字 符 串 转换 为 int 值 。 
int result = Convert.ToInt32(str, 2); 


步骤 4: 在 控制 台中 分 别 输出 转换 前 后 的 内 容 。 


Console. WriteLine( $ "\"{str}\" 一 > {result}"); 
步骤 5: 运行 应 用 程序 项 目 ,控制 台 输 出 内 容 如 下 。 


"1011101001" 一 > 745 


实例 154 Parse 与 TryParse 方法 

【导语 】 

许多 基础 的 值 类 型 都 公开 了 两 个 方法 一 一 Parse 和 TryParse。 这 两 个 方法 的 作用 相 
同 , 即 对 传 入 的 字符 串 进行 分 析 , 然 后 产生 新 的 值 类 型 实例 。 假 设 调用 Double 结构 的 Parse 


方法 ,如 果 能 够 顺利 分 析 传 递 给 方法 的 字符 串 ,就 会 返回 一 个 新 的 Double 实例 。Parse 方 
法 一 旦 分 析 失 败 就 会 抛 出 异常 。 而 TryParse 方法 在 字符 串 分 析 失 败 后 不 会 抛 出 异常 ,如 果 
分 析 成 功 , 该 方法 返回 true, 和 否则 返回 false。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 字符 串 变 量 , 将 其 通过 Parse 方法 进行 分 析 , 并 转换 为 double 类 型 
的 值 。 


string sl = "4.00012"; 
double vl = double.Parse(s1); 
Console. WriteLine(™\"{0}\" -> {1}", sl, v1); 


步骤 3: 下 面 代码 使 用 Parse 方法 对 字符 串 进行 分 析 ,然后 转换 为 DateTime 实例 。 


string s2 = "2016—11- 25"; 
DateTime v2 = DateTime.Parse(s2); 
Console. WriteLine(™\"{0}\" -> {1}", s2, v2); 


步骤 4: 接 下 来 通过 TryParse 方法 尝试 将 字符 串 转换 为 16 位 整数 值 。 


string s3 = "6507"; 

bool b = short. TryParse(s3, out short v3); 
if (b) 

{ 


Console. WriteLine("\"{0}\" 一 > {1}", s3, v3); 
} 
else 
{ 
Console. WriteLine(" 字 符 串 \"{0}\" 无 法 转换 为 16 位 整数 。"，s3); 
' 


步骤 5: 同样 ,使 用 TryParse 方法 将 字符 串 转换 为 int 实例 。 


string s4 = "69kh"; 
b = int.TryParse(s4, out int v4); 
if (b) 
{ 
Console. WriteLine("\"{0}\" 一 > {1}", s4, v4); 
} 
else 
{ 
Console. WriteLine(" 字 符 串 \"{0}\" 无 法 转换 为 32 位 整数 。"，s4) ; 
} 


由 于 变量 s4 中 包含 字母 “k” 和 *“*h”, 是 无 法 转换 成 整数 值 的 ,所 以 TryParse 方法 会 返回 false。 
步骤 6: 运行 应 用 程序 项 目 ,输出 结果 如 图 5-28 所 示 。 
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CNProgram Files\dotnet\... 一 El x 
“4. 00012™ 4. 00012 
车: 1 5-1 


“6507” 
字符 串 “"69kh 无 ; 


图 5-28 字符 串 分 析 结果 


实例 155 对 字符 串 进 行 UTF-8 编码 


【导语 】 

在 一 些 特定 情况 下 ,例如 要 将 字符 串 写 入 到 文件 中 ,或 者 要 将 字符 串通 过 网 络 发 送 ,就 
要 考虑 对 字符 串 编码 的 问题 。 因 为 计算 机 是 以 字 节 方式 存储 数据 的 ,字符 串 在 存储 前 就 需 
要 转换 为 字 节 序列 ,这 便 是 编码 的 过 程 。 

常用 的 编码 格式 有 ASCII、UTF-8、GBK、GB2312 等 。 对 于 简体 中 文字 符 , 可 以 使 用 
GB2312 编码 ,但 为 了 提高 通用 性 ,一 般 使 用 UTF-8 编码 比较 多 。 

在 System. Text 命名 空间 下 的 Encoding 类 可 以 完成 字符 串 与 字 节 序列 之 间 的 转换 。 
为 了 方便 开发 者 调用 ,Encoding 类 还 以 静态 属性 的 形式 公开 常用 编码 的 实例 。 具 体 可 参考 
代码 清单 5-1。 


代码 清单 5-1 Encoding 类 公开 的 常用 编码 格式 


public static Encoding UTF8 { get; } 

public static Encoding UTF7 { get; } 

public static Encoding UTF32 { get; } 

public static Encoding Unicode { get; } 

public static Encoding BigEndianUnicode { get; } 
public static Encoding ASCII { get; } 

public static Encoding Default { get; } 


Default 获取 的 编码 由 操作 系统 的 设置 决定 。 对 于 简体 中 文 版 本 的 操作 系统 ,一 般 为 
GB2312 编码 。 

要 获取 字符 串 编码 后 的 字 节 序列 ,可 调用 GetBytes 方法 ; 而 调用 GetString 方法 则 可 
以 从 已 编码 的 字 节 序列 中 读 出 字符 串 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 System. Text 命名 空间 。 


using System. Text; 


步骤 3: 声明 一 个 字符 串 变 量 并 进行 初始 化 。 


string str = "你 好 ,小 王 。"， 
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步骤 4: 对 字符 串 进行 UTF-8 编码 ,然后 输出 字 节 数组 。 


byte[ ] data = Encoding. UTF8.GetBytes(str); 
Console. WriteLine("utf - 8 编码 后 的 字 节 序列 :\n{f0}"，BitConverter. ToString(data)); 


步骤 5: 从 已 编码 的 字 节 数组 中 重新 读 取 字 符 串 。 


string back = Encoding.UTF8. GetString(data) 
Console. WriteLine(" 从 utf -8 编码 后 的 字 节 序列 中 读 回 字符 串 :\n{0}j"，back) ; 


注意 : 读 取 字 符 串 时 ,使 用 的 编码 格式 一 定 要 与 编码 时 所 使 用 的 编码 格式 一 致 。 如 本 例 ,六 
码 时 使 用 的 是 UTF-8 编码 ,那么 在 读 取 字 符 串 时 也 要 使 用 UTF-8 编码 。 


步骤 6: 运行 应 用 程序 项 目 ,控制 台 输出 内 容 如 图 5-29 所 示 。 


CNProgram Files\dotnet\dotnet.exe 二 口 x 


闻 列 中 读 回 他 


5-29 字符 串 编码 


实例 156 ”字符 串 的 HTML 编码 

【导语 】 

当 字符 串 被 呈现 为 HTML 文档 内 容 时 , 某 些 特殊 字符 需要 进行 转 义 ,否则 会 与 文档 中 
的 HTML 标记 冲突 。 例 如 ,字符 串 中 出 现 的 “<” 就 必须 替换 为 “&lt;， ”,“>” 就 必须 蔡 换 为 


» 


“gt; 
本 实例 将 演示 WebUtility 类 的 用 法 。 该 类 位 于 System. Net 命名 空间 下 ,其 功能 是 进 
行 字符 串 的 HTML 编码 与 解码 操作 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 字符 串 变量 并 进行 赋值 。 


string str = "<1>Item1\n<2> Item 2\n<3> Item3 & Item 4"; 


上 述 字符 串 中 含有 与 HTML 不 兼容 的 字符 , 接 下 来 将 对 这 些 字符 进行 编码 。 
步骤 3: 对 上 面 的 字符 串 进行 HTML 编码 。 


string htmlstr = WebUtility.HtmlEncode(str); 


步骤 4: 分 别 输出 原 字符 串 与 编码 后 的 字符 串 。 


册 
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WriteLine( $" 原 字符 串 :\n{str}\n"); 
WriteLine( $ "HTML 编码 后 的 字符 串 :\n{htmlstr}"); 


步骤 5: 按 下 快捷 键 F5 运行 应 用 程序 项 目 ,输出 内 容 如 图 5-30 所 示 。 


); Item 4 


图 5-30 ”HTML 编码 


实例 157 字符 串 隐 式 转换 为 自 定义 类 


【导语 】 


在 重 写 转换 运算 符 时 ,加 上 implicit 关键 字 可 以 实现 隐 式 转换 。 本 实例 将 通过 此 种 方 


式 实 现 将 string 类 型 隐 式 转换 为 自 定 义 类 的 实例 。 


假设 自 定义 类 有 4 个 公共 属性 一 一 ID、Name、Age、City, 字 符 串 由 这 4 个 


属性 的 值 组 


成 ,并 使 用 制 表 位 符 ”\t" 分 隔 。 当 实现 自 定 义 转换 时 ,将 通过 制 表 位 符 拆 分 字符 串 , 然 后 将 


拆 分 出 来 的 4 个 字符 串 分 别 赋 给 自 定义 类 的 属性 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 Student 类 ,假设 它 封装 了 与 学 员 有 关 的 信息 。 


class Student 

{ 
public int ID { get; set; } 
public string Name { get; set; } 
public int age { get; set; } 
public string City { get; set; } 

} 


步骤 3: 在 Student 类 中 实现 自 定义 隐 式 转换 ,使 得 string 实例 可 以 直接 赋值 给 


Student 变量 。 


public static implicit operator Student( string input) 
{ 
// 拆 分 字符 串 
string[ ] parts = input.Split(\t'); 
if (parts. Length != 4) 
return null; 
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return new Student 

{ 
ID = Convert. ToInt32(parts[0]), 
Name = parts[1], 
Age = Convert.ToInt32(parts[2]), 
City = parts[3] 

i 

} 


步骤 4: 在 Main 方法 中 ,声明 一 个 string 类 型 的 变量 并 赋值 , 稍 后 将 使 用 该 字符 串 来 
测试 隐 式 转换 。 

string str = "10026\t 小 张 \t28\t 成 都 "; 

步骤 5: 声明 Student 类 型 的 变量 ,直接 把 str 变量 赋 给 它 ,会 自动 完成 隐 式 转换 。 

Student stu = str; 


步骤 6: 输出 转换 后 产生 的 Student 实例 各 个 属性 的 值 。 


WriteLine(" 学 员 信息 :"); 
WriteLine( $ "学 号 :{stu. ID}\n 学 员 姓 名 : {stu. Name}\n 学 员 年 龄 :{stu. Age}\n 所 在 城市 :{stu. 
City}"); 


步骤 7: 运行 应 用 程序 项 目 ,控制 台 输 出 结果 如 图 5-31 所 示 。 


5-31 ” 隐 式 转换 产生 的 Student 实例 


泛 型 与 集合 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。 泛 型 ; 
， 数 组 ; 
”集合 ; 
。 元 组 。 


6.1 泛 型 


实例 158 ”使 用 泛 型 参数 

【导语 】 

泛 型 的 作用 是 扩大 类 型 的 灵活 性 与 通用 性 ,在 定义 类 型 (如 类 、 接 口 ) 时 可 以 设置 命名 的 
类 型 占 位 符 , 即 泛 型 参数 。 例 如 在 声明 下 面 的 Test 类 时 指定 T\F 两 个 占 位 符 。 


class Test <T, F> 
{ 
public Test(T a, F b) 
{ 
WriteLine(a. GetType( ). Name); 
WriteLine(b. GetType( ). Name); 


} 

T 与 F 就 是 泛 型 参数 ,Test 类 也 就 是 泛 型 类 。 在 调用 Test 类 时 ,用 真实 的 类 型 去 蔡 换 
泛 型 参数 ,例如 , 工 参 数 蔡 换 为 string 类 型 ,F 参数 替换 为 byte 类 型 。 

Test < string，byte> c = new Test<string, byte>("abc", 255); 

此 时 ,Test 类 的 公共 构造 函数 就 会 变 为 以 下 形式 。 


public Test( stringa, byteb ){ } 
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如 果 用 int 类 型 替换 泛 型 参数 ,用 long 类 型 蔡 换 泛 型 参数 下, 则 Test 类 的 公共 构造 
函数 变 为 以 下 形式 。 
public Test( inta, longb ) { } 


从 以 上 例子 可 以 看 出 ,使 用 泛 型 参数 可 以 增加 Test 类 的 通用 性 。 当 类 型 需要 变更 时 ， 
不 必 对 Test 类 进行 改动 ,也 不 必定 义 新 的 类 型 ,而 是 直接 用 具体 的 类 型 将 泛 型 参数 工 和 下 
替换 即 可 。 

由 于 泛 型 参数 仅仅 是 占 位 符 , 具 体 类 型 未 知 , 因 此 在 指定 泛 型 参数 时 ,不 需要 指定 类 型 ， 
只 需要 给 定 一 个 有 效 命名 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Sample 类 ,该 类 带 有 一 个 名 为 K 的 泛 型 参数 ,K 所 代表 的 类 型 将 作为 
Work 方法 的 输入 参数 p 的 类 型 。 


public class Sample < K> 
{ 
public void Work(K p) 
{ 
Console. WriteLine( $ "{p. GetType().FullName, — 20}:{p}"); 
} 
} 


在 Work 方法 内 部 ,向 控制 台 输 出 参数 的 完整 类 型 名 称 及 对 应 值 。 
步骤 3: 在 Main 方法 中 ,实例 化 6 个 Sample 对 象 。 并 使 用 不 同 的 数据 类 型 替换 泛 型 
参数 多 。 然 后 调用 Work 方法 ,并 向 方法 传递 合适 的 参数 值 。 


Sample< string> sl = new Sample< string>(); 
sl. Work("Hello"); 

Sample< DateTime > s2 = new Sample< DateTime >(); 
s2. Work (DateTime. Now) ; 

Sample< decimal > s3 = new Sample < decimal >(); 
s3. Work(0.33M); 

Sample <float> s4 = new Sample< float>(); 

s4. Work(11.954f); 

Sample < byte> s5 = new Sample < byte>(); 

s5. Work(255); 

Sample<uint > s6 = new Sample<uint>(); 

s6. Work(798652); 


向 Work 方法 传递 的 值 的 类 型 一 定 要 与 实例 化 Sample 类 时 为 泛 型 参数 多 所 指定 的 类 
型 匹配 。 例 如 ,K 的 类 型 为 byte, 则 向 Work 方法 传递 的 必须 是 byte 类 型 的 值 , 即 0 一 255 
(包括 0 和 255) 的 整数 值 , 若 K 为 string 类 型 ,那么 传递 给 Work 方法 的 值 必须 是 字符 串 。 
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步骤 4: 按 下 F5 快捷 键 ,运行 应 用 程序 ,控制 台 输 出 的 文本 如 图 6-1 所 示 。 


6-1 泛 型 参数 的 类 型 与 实例 值 


实例 159 ”实现 泛 型 接口 

【导语 】 

当 某 个 类 型 要 实现 包含 泛 型 参数 的 接口 时 ,可 以 考虑 以 下 两 种 情况 ; 

(1) 在 实现 泛 型 接口 时 就 明确 泛 型 参数 的 类 型 ,即使 用 确定 的 类 型 蔡 换 接口 中 的 泛 型 


(2) 泛 型 参数 的 类 型 依然 未 确定 ,可 以 用 当前 类 型 中 所 指定 的 泛 型 参数 去 替换 接口 中 
原 有 的 泛 型 参数 。 

本 实例 将 涉及 以 上 两 种 情况 。 

【操作 流程 】 


步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 带 泛 型 参数 的 接口 。 
public interface ITest <P, 0> 
{ 
void Output(P x, Q y); 
} 
泛 型 参数 P 和 Q 作为 Output 方法 的 输入 参数 的 类 型 。 
步骤 3: 声明 Somethingl 类 ,并 且 该 类 在 实现 ITest 接口 时 ,明确 指定 ITest 接口 的 泛 
型 参数 类 型 分 别 为 mt 和 double。 
public class Somethingl : ITest< int, double> 
{ 
public void Output (int x, double y) 
{ 
WriteLine("{0} — {1}", x.GetType(), x); 
WriteLine("{0} — {1}\n", y.GetType(), y); 


} 


步骤 4: 声明 Something2 类 ,该 类 也 带 有 泛 型 参数 ,并 用 该 类 的 泛 型 参数 蔡 换 ITest 接 
口 的 泛 型 参数 。 
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public class Something2 <J, K> : ITest<J, K> 
和 
public void Output(J x, K y) 
{ 
WriteLine("{0} 一 {1}", x.GetType(), x); 
WriteLine("{0} — {1}\n", y.GetType(), y); 


} 
步骤 5: 在 Main 方法 中 ,实例 化 Somethingl 对 象 , 并 调用 Output 方法 。 


Somethingl v1 = new Something1(); 

v1. Output(500, 99.88d); 

在 声明 Somethingl 类 的 时 候 已 经 明确 使 用 了 int 和 double 类 型 蔡 换 ITest 接口 中 的 
泛 型 参数 ,因此 Output 方法 的 第 一 个 参数 只 能 是 int 类 型 ,第 二 个 参数 只 能 是 double 类 型 。 

步骤 6: 实例 化 一 个 Something2 类 型 的 对 象 ,并 指定 泛 型 参数 为 uint 和 ushort 类 型 。 


Something2 <uint, ushort > v2 = new Something2 <uint, ushort >(); 

V2. Output(9009, 17); 

步骤 7: 再 实例 化 一 个 Something2 对 象 ,将 泛 型 参数 
替换 为 char 类 型 和 string 类 型 。 

Something2 < char, string > v3 = new Something2 < char, 

string >(); 

v3.0utput('c', "cat"); 

由 于 在 声明 Something2 类 的 时 候 同时 指定 了 泛 型 参 
数 , 所 以 在 实例 化 该 类 时 可 以 使 用 各 种 类 型 来 蔡 换 证 型 


参数 。 图 6-2 调用 实现 了 泛 型 接口 的 类 
步骤 8: 运行 应 用 程序 项 目 ,屏幕 输出 内 容 如 图 6-2 

所 示 。 
实例 160 ”限制 泛 型 参数 只 能 使 用 值 类 型 
【导语 】 


因为 泛 型 参数 可 以 是 任意 类 型 ,所 以 如 果 编 译 器 仅仅 将 参数 假定 为 Object 类 型 ( 即 按 
照 Object 类 的 成 员 进行 访问 ) ,那么 代码 在 访问 某 些 特定 类 型 时 就 会 引发 编译 错误 。 

为 了 避免 引发 编译 错误 ,有 时候 需 要 对 泛 型 参数 进行 限制 ,也 就 是 泛 型 约束 。 常 用 的 泛 
型 约 东 如 下 。 

(1) class: 限制 泛 型 参数 的 类 型 必须 是 类 (引用 类 型 )。 

(2) struct: 限制 泛 型 参数 的 类 型 必须 是 结构 ( 值 类 型 ) 。 

(3) new(): 要 求 类 型 必须 包含 公共 的 .无 参数 的 构造 函数 。 当 使 用 多 个 约束 时 ,new() 必 
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须 放 到 最 后 。 

(4) unmanaged: 要 求 类 型 是 非 托 管 类 型 。 此 约束 不 常用 。 

(5) 接口 或 者 基 类 : 要 求 类 型 必须 实现 指定 接口 ,或 者 必须 从 指定 类 型 派生 。 

泛 型 约束 可 以 组 合 使 用 ,例如 下 列 泛 型 类 要 求 类 型 参数 是 引用 类 型 (class) ,而 且 要 实 
现 IService 接口 。 


public class MainItem <U> where U: class，IService 


{ 


} 
泛 型 约束 的 使 用 方法 是 在 声明 类 型 或 类 型 成 员 之 后 应 用 where 关键 宇 ,然后 才 是 类 型 
参数 的 约束 条 件 。 如 果 有 多 个 泛 型 参数 ,也 可 以 用 多 个 where 关键 字 ,格式 如 下 。 
public class SomeOne <T, S> 
where T : class, new() 


where S : ITask 
{ 


} 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 类 ,命名 为 Test, 带 有 一 个 泛 型 参数 工 。 


class Test <T> 


{ 
} 
步骤 3: 对 泛 型 参数 T 进行 约束 ,限制 只 能 是 值 类 型 , 即 类 型 为 结构 。 


class Test <T> where T : struct 


{ 


3 
步骤 4: 在 类 中 声明 一 个 Start 方 法, 并且 接受 一 个 本 类 型 的 参数 。 


public void Start(T x) 
{ 
string CheckType(Type t) => t.IsValueType ? "是 " : "不 是 "; 
Type type = x.GetType(); 
Console. WriteLine( $ "{type. Name} {CheckType(type) } 值 类 型 。") ; 
} 


CheckType 是 一 个 内 联 方 法 , 它 的 格式 与 方法 类 似 ,但 不 需要 指定 访问 修饰 符 ,一 般 用 
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于 实现 简单 的 逻辑 处 理 。 如 本 例 中 的 CheckType, 只 是 用 于 判断 类 型 T 是 否 为 值 类 型 ,如 
果 是 返回 字符 串 * 是 ”, 和 否则 返回 字符 串 “ 不 是 ”。 

步骤 5: 回 到 Main 方法 ,用 定义 好 的 泛 型 类 声明 一 个 变量 ,然后 创建 一 个 新 实例 。 随 
后 调用 Start 方法 ,此 时 类 型 参数 工 为 int 类 型 。 


Test< int> tv = new Test < int >(); 

tv. Start(100); 

步骤 6: 类 似 地 ,再 声明 一 个 Test 类 的 变量 并 实例 化 ,然后 调用 Start 方法 ,类 型 参数 
为 byte 类 型 。 


Test<byte> tq = new Test < byte>(); 
tq. Start(152); 


步骤 7: 运行 应 用 程序 项 目 , 显 示 以 下 输出 信息 。 


Int32 是 值 类 型 。 
Byte 是 值 类 型 。 


注意 : 由 于 在 声明 Test 类 时 已 经 给 类 型 参数 工 添加 了 约束 条 件 , 所 以 在 声明 Test 类 的 变 
量 时 ,类 型 参数 只 能 使 用 值 类 型 ,不 能 使 用 引用 类 型 。 


实例 161 泛 型 方法 


【导语 】 

泛 型 方法 的 声明 方式 与 泛 型 类 相似 ,在 方法 名 称 后 直接 指定 泛 型 参数 ,而 且 也 可 以 使 用 
类 型 约束 。 

调用 泛 型 方法 时 可 分 两 种 情况 讨论 : 

(1) 如 果 类 型 参数 被 用 于 输入 参数 ,那么 在 调用 泛 型 方法 的 时 候 不 需要 明确 指定 参数 
类 型 ,编译 器 会 根据 输入 参数 的 值 推断 出 类 型 。 例 如 下 面 的 调用 代码 ,根据 传递 给 方法 参数 
的 值 ,编译 器 可 推断 出 泛 型 参数 类 型 为 string 。 

obj. SetVal( "abcdefg" ); 

实际 上 ,相当 于 以 下 形式 。 

obj. SetVal < string>( "abcdefg" ); 

(2) 如 果 泛 型 参数 作为 方法 返回 值 ,那么 在 调用 方法 时 应 当 明 确 指定 类 型 ,因为 编译 器 
不 能 推断 出 返回 值 的 类 型 。 

本 实例 将 演示 泛 型 方法 的 声明 与 调用 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
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步骤 2: 声明 两 个 类 ,分 别 命 名 为 A、B, 稍 后 在 调用 泛 型 方法 时 使 用 。 


public class A{} 
public class B{ } 


步骤 3: 声明 一 个 Sample 类 。 


class Sanple 


. 


和 


步骤 4: 在 Sample 类 中 声明 DoSomething 方法 ,该 方法 带 有 一 个 类 型 参数 T, 而 且 还 
包含 一 个 工 类 再 的 输入 参数 。 


public void DoSomething<T>(T p) 

Where T : struct 
{ 

Console. WriteLine("{0} — {1}", p.GetType().Name, p); 
} 


类 型 参数 T 被 限制 为 值 类 型 ,类 型 为 结构 。 
步骤 5: 声明 GetSomething 方法 ,此 方法 带 有 类 型 参数 T, 方 法 的 返回 值 类 型 也 为 工 。 


public T GetSomething <T>() 
where T : class, new() 

{ 
return new T(); 


} 

在 方法 中 ,为 了 能 够 通过 new 运算 符 返 回 工 类 型 的 实例 ,对 工 类 型 做 了 约束 ,T 必须 是 
引用 类 型 (类 ) ,而 且 具 备 无 参数 的 公共 构造 函数 。 

步骤 6: 在 Main 方法 中 ,实例 化 Sample 类 。 


Sample s = new Sample(); 


步骤 7: 调用 Sample 类 实例 的 DoSomething 方法 ,由 于 类 型 参数 在 方法 中 作为 输入 参 
数 的 类 型 ,编译 器 可 以 根据 赋值 推断 类 型 ,因此 无 须 明 确 指 定 类 型 。 


// char 

s. DoSomething( 'z'); 

// byte 

s. DoSomething( (byte)5); 
// double 

s. DoSomething(6. 3333d); 
// int 

s. DoSomething(777); 
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步骤 8: 调用 GetSomething 方法 ,由 于 类 型 参数 作为 返回 值 的 类 型 ,无 法 自动 推断 类 
型 ,所 以 必须 明确 指定 工 的 类 型 。 


Axa = s.GetSomething<A>(); 
Bxb = s.GetSomething<B>(); 


实例 162 ”将 泛 型 参数 限制 为 枚 举 类 型 


【导语 】 

虽然 将 泛 型 参数 约束 为 枚 举 类 型 的 情形 不 多 见 , 在 实际 开发 中 也 不 常用 ,但 是 可 以 将 其 
作为 一 种 开发 技巧 进行 了 解 。 实 现 方法 是 把 约束 条 件 设 定 为 System. Enum 类 型 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 项 目 模板 生成 的 Program 类 中 添加 一 个 静态 方法 。 该 方法 带 有 一 个 泛 型 参 
数 工 ,并 将 类 型 T 约束 为 枚 举 类 型 ,其 输入 参数 的 类 型 也 是 T。 


static (string, int) CallTest <T>(T p) 
where T: Enum 


L 


// 获取 常量 名 称 
string name = Enum. GetName(p.GetType(), p); 
// 获取 常 值 


int value = Convert. ToInt32(p); 
return (name, value); 
} 
方法 的 返回 类 型 是 元 组 ,里 面包 含 一 个 string 类 型 的 值 以 及 一 个 int 类 型 的 值 。 在 方 
法 体内 部 ,通过 Enum. GetName 方法 得 到 传递 给 方法 参数 的 枚 举 常量 的 名 称 ; 而 如 果 需 要 
获取 枚 举 值 ,直接 将 其 转换 为 nt 类 型 即 可 。 
步骤 3: 为 了 便于 稍 后 测试 ,可 以 声明 一 个 枚 举 类 型 。 


public enum Oper 
{ 


Open = 5, 
Close = 12, 
Reset = 6 


} 
步骤 4: 在 Main 方法 中 ,测试 CallTest 方 法 的 调用 。 
(string Name, int Val) res = CallTest(Oper. Open); 


在 接收 方法 的 返回 值 时 ,可 以 为 元 组 中 的 项 重新 命名 ,例如 在 本 例 中 ,将 string 类 型 的 
项 命名 为 Name, 将 int 类 型 的 项 命名 为 Val。 
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步骤 5: 在 控制 台中 输出 结果 。 

Console. WriteLine( $ " 枚 举 常量 名 : {res. Name} ,常量 值 : {res. Val}"); 
步骤 6: 运行 应 用 程序 项 目 ,屏幕 的 输出 内 容 如 下 。 

枚 举 常 量 名 :0pen, 常量 值 :5 


实例 1 
【导语 】 


63” 泛 型 参数 的 输入 与 输出 


如 果 泛 型 参数 不 带 任何 修饰 符 , 那 么 在 分 配对 象 实例 时 ,类 型 参数 只 能 是 固定 的 类 型 。 
例如 以 下 形式 。 


Class <A> x = new Class <A>(); 


假设 B 类 从 A 类 派生 , 则 分 配 以 下 对 象 实例 时 会 报错 。 


Class <A> x = new Class <B>(); 


因为 泛 型 参数 未 使 用 任何 修饰 符 ,使 得 参数 类 型 是 固定 的 。 声 明 变 量 时 使 用 的 是 A 类 


型 ,而 分 配对 象 实例 时 使 用 的 是 B 类 型 ,前 后 不 一 致 ,会 出 现 编译 错误 。 

要 使 泛 型 中 的 类 型 参数 成 为 变 体 , 一 般 可 以 使 用 两 个 修饰 符 一 一 in 和 out。 带 in 修饰 
符 的 是 “输入 类 型 ,此 类 型 参数 一 般 用 于 委托 或 方法 的 输入 参数 ,属于 逆 变 。 带 out 修饰 符 
的 是 “输出 类 型 ,一般 用 于 委托 或 方法 的 返回 值 , 属 于 协 变 。 

泛 型 的 输入 /输出 类 型 参数 只 能 用 于 委托 和 接口 两 种 数据 类 型 ,不 能 用 于 类 与 结构 ,而 
且 作 为 类 型 参数 的 类 型 不 能 是 值 类 型 。 


【操作 流程 


步骤 1: 
步骤 2: 


新 建 一 个 控制 台 应 用 程序 项 目 。 
声明 两 个 类 , 稍 后 用 于 测试 。 


public class Ball { } 
public class FootBall : Ball { } 


FootBall 类 从 Ball 类 派生 。 按 照 隐 式 转换 的 要 求 ,FootBall 类 的 实例 可 以 赋值 给 使 用 
Ball 类 型 声明 的 变量 。 


步骤 3: 


声明 两 个 带 可 变 类 型 参数 的 泛 型 接口 。 


public interface ITestl< inT>{} 
public interface ITest2<out T>{ } 


在 ITest 
ITest2 接口 
协 变 。 


1 接口 中 ,T 类 型 参数 使 用 了 in 修饰 符 ,表示 它 是 一 个 输入 类 型 , 即 逆 变 。 在 
Ph ,全 类 型 参数 使 用 了 out 修饰 符 ,表示 该 类 型 将 作为 输出 参数 (返回 值 ), 即 


第 6 章 ” 泛 型 与 集合 | 这 189 


步骤 4: 声明 两 个 类 ,分 别 实现 ITestl 和 ITest2 接口 。 


public class Test1 <T> : ITest1<T>{} 
public class Test2 <T> : ITest2<T>{} 


步骤 5: 在 Main 方法 中 用 ITestl 接口 声明 变量 ,类 型 参数 为 FootBall 类 ,然后 用 
Test]l 类 的 新 实例 进行 赋值 ,类 型 参数 为 Ball 类 。 


ITest1 <FootBall > tl = new Test1<Ball >(); 


上 述 情 况 属 于 逆 变 。tl 变量 的 泛 型 参数 只 能 接受 FootBall 类 型 ,而 它 所 引用 的 实例 的 
泛 型 参数 则 可 以 接受 Ball 和 FootBall 两 个 类 型 ,可 以 看 到 ,赋值 之 后 实例 能 分 配 的 兼容 性 
变 小 了 , 当 通 过 tl 变量 调用 相关 成 员 时 ,只 能 使 用 FootBall 类 。 

步骤 6: 用 ITest2 接口 声明 变量 ,并 指定 泛 型 参数 为 Ball 类 ,使 用 Test2 实例 赋值 的 ， 
泛 型 参数 为 FootBall 类 。 


ITest2 <Ball > t2 = new Test2 <FootBall >(); 


变量 t2 能 够 接受 Ball 和 FootBall 两 种 类 型 的 返回 值 ,而 它 所 引用 的 实例 只 能 返 芭 
FootBall 类 型 的 对 象 。 当 使 用 t2 变量 调用 相关 成 员 时 ,由 于 ITest2 < Ball > 的 分 配 兼容 性 
较 大 ,能 够 顺利 引用 Test2 < FootBall > 实例 所 返回 的 对 象 , 此 情况 属于 协 变 。 


实例 164 ”在 委托 类 型 中 使 用 泛 型 


【导语 】 

框架 类 库 自 带 的 Action 和 Func 委托 都 属于 泛 型 委托 。 其 中 ,Action 委托 适 配 返 回 类 
型 为 void 的 方法 ,参数 个 数 为 0 到 16 个 , 泛 型 参数 都 使 用 了 in 修饰 符 ; Func 委托 的 输入 
参数 个 数 为 0 到 16 个 ,并 带 有 一 个 输出 参数 (其 泛 型 参数 使 用 out 修饰 符 ), 这 个 输出 参数 
就 是 方法 的 返回 值 。Func 委托 用 于 匹配 返回 非 void 类 型 的 方法 。 

在 开发 过 程 中 ,不 仅 可 以 使 用 现成 的 Action 和 Func 委托 ,开发 人 员 也 可 以 声明 自己 所 
需要 的 泛 型 委托 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 委托 类 型 ,并 带 有 泛 型 参数 。 


public delegate R MyTestDel < in Al, in MB2, out R>(Al m, A2 n) 
where Al:struct 


where A2: struct; 


其 中 ,Al、A2 是 输入 参数 ,R 是 输出 参数 ,并 且 约 束 Al 和 A2 类 型 必须 是 值 类 型 。 
步骤 3: 用 上 面 声 明 的 委托 定义 变量 ,并 初始 化 。 


MyTestDel < int, byte, string> test = (a, b) => 
{ 
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string ret = $ "type = {a.GetType().Name}, value = {a}\ntype = {b. GetType(). 
Name}, value = {b}"; 
return ret; 
}; 
通过 填充 类 型 参数 ,使 得 委托 实例 的 输入 参数 分 别 为 int 
和 byte, 返 回 类 型 为 string。 
步骤 4: 尝试 调用 委托 实例 ,并 将 调用 结果 输出 到 控制 台 。 


Console. WriteLine(test(350, 27)); 图 6-3 泛 型 委托 调用 结果 
步骤 5: 运行 应 用 程序 项 目 , 得 到 的 输出 结果 如 图 6-3 所 示 。 


实例 165 ”将 抽象 类 作为 类 型 约束 

【导语 】 

将 泛 型 参数 约 东 为 抽象 类 或 者 接口 ,可 以 有 效 规范 对 类 型 实例 的 访问 ,这 在 实际 开发 中 
比较 实用 。 如 果 不 给 类 型 参数 添加 约束 ,那么 在 默认 情况 下 编译 器 就 以 Object 类 的 成 员 进 
行规 范 ,这 会 带 来 诸多 不 便 。 

然而 如 果 使 用 抽象 类 或 者 接口 来 约束 类 型 参数 ,那么 在 访问 参数 实例 时 就 很 方便 了 。 
例如 声明 一 个 接口 ,名 为 IService, 接 口中 明确 声明 两 个 方法 一 一 Open 和 Close。 在 泛 型 参 
数 中 添加 约束 ,要求 类 型 必须 实现 IService 接口 。 在 这 种 情况 下 ,访问 泛 型 参数 实例 的 代码 
不 需要 关心 有 多 少 个 类 实现 了 IService 接口 ,因为 不 管 是 哪个 类 ,只 要 它 实 现 了 该 接口 , 必 
然 会 包含 Open 和 Close 这 两 个 方法 ,如 此 一 来 ,代码 只 需要 调用 方法 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 为 了 便于 稍 后 测试 , 先 声明 一 个 抽象 类 Animal, 它 表示 所 有 动物 ,同时 包含 一 
个 抽象 的 CheckIn 方法 。 


/// < summary> 
/// 公共 基 类 
/// </sunmary> 
public abstract class Animal 
{ 
public abstract void CheckIn(); 
} 


所 有 从 Animal 类 派生 的 类 都 必须 实现 CheckIn 方法 。 
步骤 3: 声明 4 个 新 类 ,都 实现 Animal 抽象 类 , 详 见 代 码 清 单 6-1 。 
代码 清单 6-1 4 个 实现 Animal 类 的 新 类 


/// < summary> 


/// 猫 岗 
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/// </sunmary> 
public class Meerkat : Animal 
{ 
public override void CheckIn() 
{ 
Console. WriteLine(" 这 是 猫 抽 。\n"); 
} 
} 


/// < summary> 
/// 狐狸 
/// </sunmary> 
public class Fox : Animal 
Ui 
public override void CheckIn() 
{ 
Console. WriteLine(" 这 是 狐狸 。\n"); 
} 
} 


/// < summary> 
1// 鸡 
/// </sunmary> 
public class Chicken : Animal 
{ 
public override void CheckIn() 
{ 
Console. WriteLine(" 这 是 鸡 。\n"); 
上 
} 


/// < summary> 
/// 葛 葛 
/// </sunmary> 
public class Quail : Animal 
{ 
public override void CheckIn() 
{ 
Console. WriteLine(" 这 是 玖 刘 。\n"); 
’ 
} 


步骤 4: 声明 一 个 汉 型 接口 ,将 类 型 参数 标注 为 输入 参数 ,这 样 可 以 在 后 续 使 用 中 支持 
传递 不 同 派生 程度 的 类 。 
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public interface ITest < in T> 


{ 
void DoWork(T pr); 
步骤 5: 声明 泛 型 类 ,并 实现 上 面 的 泛 型 接口 ,将 类 型 参数 约束 为 必须 是 从 Animal 派 
生 的 类 。 


public class TestAnl <T> : ITest <T> 
where 了 : Animal 
{ 
public void DoWork(T pr) 
' 
// CheckIn 方法 是 在 抽象 类 中 定义 的 
// 所 有 实现 该 抽象 类 的 类 型 都 能 访问 
pr. CheckIn(); 


} 


步骤 6: 使 用 ITest 接口 声明 一 个 变量 ,然后 使 用 TestAnl 类 的 新 实例 对 其 初始 化 ,类 
型 参数 使 用 Animal 类 ,这 样 做 能 够 增加 调用 DoWork 方法 的 灵活 性 ,能 够 向 该 方法 传递 各 
种 Animal 类 的 子 类 实例 。 

ITest< Rnimal > t = new TestAnl < Animal >(); 

步骤 7: 调用 DoWork 方法 ,依次 将 Animal 类 的 4 
个 派生 类 的 实例 传递 进去 。 

t. DoWork( new Fox( ) ); 

t. DoWork(new Meerkat() ) 

t. DoWork(new Quail() ) 

t. DoWork(new Chicken( )); 

步骤 8: 按 F5 快捷 键 运行 实例 ,控制 台 输 出 结果 如 
图 6-4 所 示 。 


图 6-4 4 个 子 类 的 调用 结果 


6.2 数组 


实例 166 ”四 种 方式 初始 化 数组 实例 

【导语 】 

在 创建 数组 实例 时 ,一 般 有 四 种 方式 可 以 对 数组 实例 中 的 元 素 进 行 初始 化 。 
(1) 实例 化 数组 时 明确 指定 元 素 个 数 ,并 在 创建 实例 后 ,依次 给 每 个 元 素 赋 值 。 


int[] x = new int[3]; 


对 0 = 18 
E 
x[2] = 3; 


(2) 在 创建 数组 实例 时 明确 指定 元 素 个 数 ,随后 直接 初始 化 。 


int[] v = new int[3] { 1, 8, 3 }; 
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(3) 在 实例 化 数组 对 象 时 不 指定 元 素 个 数 ,而 是 由 初始 化 的 元 素来 确定 元 素 个 数 。 


int[] t = new int[] { 33, 4, 105, 80 } 


(4) 这 是 第 三 种 方式 的 简写 ,实例 化 数组 时 直接 用 元 素来 填充 。 


int[] = {16, 27, 63, 91}; 


本 实例 将 演示 使 用 以 上 四 种 方式 来 初始 化 数组 对 象 。 
【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 创建 新 的 数组 实例 ,并 对 元 素 逐 一 初始 化 。 


string[ ] arrl = new string[4]; 


arrl[0] = "how"; 
arrl[1] = "old"; 
arrl[2] = "are"; 
arrl[3] = "you"; 


步骤 3: 在 创建 数组 实例 的 同时 对 元 素 进行 初始 化 ,数组 大 小 已 确定 。 


double[ ] arr2 = new double[2] { 0.0012d，6.008d } 
步骤 4: 数组 大 小 未 确定 ,通过 填充 元 素来 决定 其 大 小 。 


long[ ] arr3 = new long[] { 355558L, 70001L, 6969221L }; 


步骤 5: 数组 大 小 未 确定 ,通过 简化 语法 使 用 数组 元 素 直 接 填充 。 


uint[] arr4 = { 3608, 270, 4256, 8088, 6120 } 


实例 167 创建 二 维 数组 
【导语 】 


日 常 开发 中 ,一 维 数组 的 使 用 频率 最 高 ,偶尔 会 用 到 二 维 数组 ,二 维 以 上 的 数组 极 少 使 
用 。 一 维 数组 的 声明 方式 是 在 类 型 后 面 跟随 一 对 空 的 中 括号 ; 二 维 数组 的 声明 方式 就 是 在 


中 括号 中 添加 一 个 逗号 (英文 ); 三 维 数组 的 声明 方式 就 是 


h 括 号 


P 添 加 两 个 逗号 ,其 他 维 
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例如 ,以 下 代码 声明 一 个 元 素 为 char 类 型 的 二 维 数组 。 

char[, ] chs; 

以 下 代码 声明 三 维 数组 。 

char[,, ] chs; 

多 维 数组 的 元 素 个 数 为 每 个 维度 中 元 素 个 数 的 乘积 。 例 如 ,int[2,3,5] 有 三 个 维度 ,元 
素 个 数 =2X3X5, 即 30 个 元 素 。 

【操作 流程 】 

步骤 1: 创建 一 个 控制 台 应 用 项 目 。 

步骤 2: 声明 一 个 二 维 数组 ,然后 实例 化 。 


float[,] da = new float[5, 3]; 


步骤 3: 为 数组 中 的 元 素 赋值 。 


da[0, 0] = 0.1101f; 
da[0, 1] = 0.1102f; 
da[0, 2] = 0.1103f; 
da[1，0] = 0.1212f; 
da[l1, 1] = 0.1105f; 
da[1,， 2] = 0.1204f; 
da[2, 0] = 0.1015f; 
da[2，1] = 0.1217f; 
da[2，2] = 0.1005f; 
da[3，0] = 0.1705f; 
da[3，1] = 0.1303f; 
da[3, 2] = 1.1002f; 
da[4, 0] = 2.1217f; 
da[4, 1] = 2.3015f; 
da[4, 2] = 2.2165f; 


访问 二 维 数组 中 的 元 素 时 ,第 一 个 索引 定位 第 一 维度 的 位 置 , 第 二 个 索引 定位 第 二 维度 
的 位 置 ,该 数组 对 象 共有 15 个 元 素 。 
步骤 4: 通过 for 循环 ,输出 二 维 数组 中 所 有 元 素 的 值 。 


for(int x = 0; x<5; xt+) 
{ 
for(inty = 0; y<3; yt+) 
{ 
Console. Write( $ "[{x}, {y}] : {da[x, y]} "); 
} 


Console. Write("\n"); 
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由 于 是 二 维 数组 ,需要 髓 套 两 个 for 循环 。 外 层 for 循环 用 于 访问 第 一 维度 的 元 素 , 内 
层 for 循环 用 于 访问 第 二 维度 的 元 素 。 
步骤 5: 运行 应 用 程序 项 目 ,控制 台 上 的 输出 如 图 6-5 所 示 。 


图 6-5 输出 二 维 数组 中 的 元 素 


实例 168 ”使 用 简化 语法 初始 化 多 维 数组 


【导语 】 
- 维 数组 初始 化 的 简化 语法 比较 简单 ,只 需要 一 对 大 括号 将 元 素 括 起 来 ,例如 以 下 
格式 。 
double[] a = { 0.00015d, 0.00000058d, 0.0012d } ; 
多 维 数组 初始 化 的 方法 类 似 , 只 是 在 大 括号 中 需要 杉 套 大 括号 , 幅 套 的 层 数 与 数组 的 维 
数 相同 。 
例如 ,要 初始 化 二 维 数组 int[2,3] ,需要 内 套 两 层 大 括号 。 方 法 是 在 最 外 层 大 括号 中 藤 
套 2 个 大 括号 ,而 每 个 大 括号 中 包含 3 个 元 素 , 格 式 如 下 。 
int[,] vk = 
{ 
{1 2 3 
{4,5,6} 
}; 


但 是 ,不 能 写成 以 下 形式 。 


ntfr] b= 
{ 
{1,2}, 
{3,4}, 
{5,6} 
}; 


因为 这 样 就 会 变 成 intL3,2] 了 ,虽然 元 素 的 总 数 都 是 6, 但 数组 的 结构 是 不 同 的 。 
再 例如 ,三 维 数组 int[2,3,2] 的 元 素 总 数 为 12, 类 似 地 ,因为 有 三 个 维度 ,所 以 要 髓 套 
三 层 大 括号 。 顶 层 大 括号 封装 整个 数组 对 象 , 它 里 面包 含 两 个 大 括号 , 即 为 第 二 层 ; 第 二 层 
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中 的 每 个 大 括号 里 面 都 包含 三 个 大 括号 , 即 为 第 三 层 ; 在 第 三 层 中 ,每 个 大 括号 里 面 都 包含 
两 个 int 类 型 的 元 素 。 代 码 如 下 。 


int[,,] c= 
{ 
{ 
10 1 
ti 
ti 


{31, 32}, 
{ 33, 34 }, 
{ 35，36 } 


] 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 用 简化 语法 初始 化 一 个 二 维 数 组 。 


long[,] a = 
{ 


340001, 340002, 340003, 340006 
la 
{ 
7874225, 724435, 6868000, 602500 
bi 
{ 
552558, 201112, 7800002, 3200025 
ja 
5800001, 5800002, 57000003, 57000021 
1.173 
{ 
1320002, 1320005, 1320006, 1320008 
},/74 
{ 
6006001, 97900047, 8900523, 36554225 
FE 
}; 


该 数组 为 long[6,4], 共 24 个 元 素 。 
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步骤 3: 初始 化 一 个 三 维 数组 。 


short[,,] b = 
{ 
{ 
{ 
20,14,15,61,62 
},.//0 
{ 
8,54,25,81,9 
ha 
{ 
32,33,34, 35, 36 
1.712 
和 
43,44, 45, 46, 47 
} /73 
},170 
{ 
4 
99,98,97,96,95 
},//0 
{ 
84,83,82, 81, 80 
EA 
{ 
100, 101, 102,103,104 
ba 
{ 
151,150,153 150155 
} /1/3 
FR 
}; 


该 数组 为 三 维 数组 short[2,4,5], 共 40 个 元 素 。 
步骤 4: 将 以 上 两 个 数组 对 象 的 元 素 输出 到 控制 台 。 


Console.WriteLine( $ "数组 {nameof(a)} 有 {a. Length} 个 元 素 , 它 们 分 别 是 :"); 
foreach(var x ina) 
{ 
Console. Write("{0} ", x); 
} 
Console.WriteLine( $"\n\n 数 组 {nameof(b)} 有 {b.Length} 个 元 素 ,它们 分 别 是 :"); 
foreach(var x in b) 
{ 
Console. Write( $ "{x} "); 
} 
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步骤 5: 运行 应 用 程序 ,控制 台 的 输出 内 容 如 图 6-6 所 示 。 


CAprogramFiles\dome\.. — 口 x 


图 6-6 输出 多 维 数组 中 的 元 素 


实例 169 使 用 Array 类 创建 数组 实例 


【导语 】 

创建 数组 实例 ,不 仅 可 以 使 用 基于 编程 语言 的 表达 式 ,还 可 以 使 用 . NET 中 的 内 置 类 型 
来 实现 。Array 类 是 所 有 数组 类 型 的 隐 式 基 类 , 它 与 代码 中 所 使 用 的 数组 实例 之 间 的 继承 
关系 是 由 编译 器 来 完成 的 ,开发 人 员 不 需要 编写 实现 代码 。 

Array 类 公开 CreateInstance 静态 方法 ,调用 该 方法 后 直接 产生 一 个 新 的 数组 实例 , 虽 
然 在 方法 签名 中 它 的 返回 值 类 型 是 Array, 但 在 运行 阶段 调用 时 , 它 会 返回 数组 对 象 的 实际 
类 型 。 因 此 在 调用 CreateInstance 方法 之 后 , 既 可 以 将 其 返回 的 对 象 强 制 转 换 为 实际 的 数 
组 类 型 来 操作 ,也 可 以 直接 调用 Array 类 的 实例 方法 进行 操作 ,例如 可 以 调用 SetValue 方 
法 在 数组 的 指定 索引 处 设置 元 素 ,或 调用 GetValue 方法 获取 指定 索引 处 的 元 素 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 调用 CreateInstance 方法 产生 一 个 double 数组 。 


double[ ] a = (double[ ])Array. CreateInstance(typeof(double), 3); 


CreateInstance 方法 的 elementType 参数 用 于 指定 数组 元 素 的 类 型 ,此 处 为 double 类 
型 ; 后 面 的 参数 用 于 指定 每 个 维度 的 长 度 ( 即 元 素 个 数 )。 由 于 该 数组 为 一 维 数组 ,因而 3 
表示 该 数组 将 包含 3 个 元 素 。 

步骤 3: 为 数组 的 每 个 元 素 赋值 。 

a[0] = 656.3775d; 


a[1] = 12.399d; 
a[2] = 800.187d; 


步骤 4: 调用 CreateInstance 方法 创建 一 个 二 维 数组 。 


byte[, ] b = (bytel[, ])Array. CreateInstance(typeof(byte), 5, 4); 
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步骤 5: 为 数组 中 各 元 素 赋值 。 


b[0, 0] = 1; 
b[0, 1] = 3; 
b[o, 2] = 4; 
二 
b[1, 0] = 10; 
ML, 1 = 1 
bf[lr 2] = 12; 
Hi 3] = 13; 
b[2, 0] = 14; 
M2 1 = 5 
b[2, 2] = 16; 
二 加 
MS 0 = 35; 
b[3, 1] = 36; 
b[3, 2] = 37; 
b[3, 3] = 38; 
b[4, 0] = 94; 
b[4, 1] = 201; 
b[4, 2] = 202; 
b[4, 3] = 203; 


实例 170” SetValue 方法 与 GetValue 方法 


【导语 】 

除了 在 代码 中 通过 语言 表达 式 直 接 操作 数组 外 ,还 可 以 通过 Array 类 的 一 些 成 员 方法 
来 操作 数组 ,较为 典型 的 是 设置 或 获取 数组 的 元 素 。 

SetValue 方法 在 数组 对 象 的 指定 索引 处 设置 元 素 , 相 应 地 ,GetValue 方法 可 以 获取 指 
定 索引 处 的 元 素 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 调用 CreateInstance 方法 产生 数组 实例 。 


Array arr = Array.CreateInstance(typeof(string), 7); 
步骤 3: 为 数组 对 象 设置 元 素 。 


arr. SetValue( "星期 日 ", 0); 
arr. SetValue( "星期 一 "，1); 
arr. SetValue( "星期二"，2); 
arr. SetValue( "星期 三 "，3); 
arr. SetValue(" 星 期 四 "，4); 
arr. SetValue( "星期 五 "，5); 
arr. SetValue( "星期 六 "，6); 
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步骤 4: 依次 输出 数组 中 的 元 素 。 调 用 GetValue 方法 获取 与 索引 相对 应 的 元 素 。 
Console. WriteLine(" 此 数组 有 {0} 个 元 素 。", arr. Length) ; 
Console. WriteLine(" 这 些 元 素 分 别 是 :"); 
System. Text. StringBuilder strbd = new System. Text. StringBuilder(); 
for(int i = 0; i<arr.Length; i++) 
{ 

strbd. Append(arr. GetValue(i) + " "); 
} 
Console. WriteLine( strbd); 


步骤 5: 运行 应 用 程序 ,屏幕 输出 的 信息 如 图 6-7 所 示 。 
实例 171 获取 某 个 维度 的 元 素 个 数 


【导语 】 

每 个 数组 实例 都 有 两 个 实例 方法 ,可 以 获取 到 数组 中 指定 维度 的 元 素 个 数 。 它 们 分 
别 是 : 

int GetLength( int dimension); 

long GetLongLength( int dimension) ; 
其 中 ,dimension 参数 用 于 指定 维 数 ,计数 从 0 开始 , 即 第 一 维度 为 0, 第 二 维度 为 1, 第 三 维 
度 为 2, 依次 类 推 。 

两 个 方法 的 作用 相同 ,都 是 获取 特定 维度 上 的 元 素 个 数 。 带 “Long ”的 方法 主要 在 当 数 
组 中 元 素 个 数 超出 32 位 整数 的 上 限时 使 用 ,一 般 调 用 GetLength 即 可 。 


图 6-7 GetValue 方 法 
获取 数组 元 素 


注意 : 数组 实例 的 Length 或 LongLength 属性 获取 的 是 数组 中 所 包含 元 素 的 总 数 ,不 考虑 
维度 。 


【操作 流程 】 
步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 创建 一 个 三 维 数组 并 初始 化 。 


i 
{ 
i 


605, 621, 319, 24 


703, 105, 94, 8 
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30, 252, 4502, 2 


785, 1, 12, 36 


109, 408, 216, 5 


562, 306, 54, 37 


步骤 3: 分 别 获取 三 个 维度 上 元 素 的 个 数 ,并 进行 输出 。 


// 获取 第 一 维度 的 元 素 个 数 

int len = a.GetLength(0); 

Console. WriteLine( $ "第 一 维度 有 {len} 个 元 素 。"); 
// 获取 第 二 维度 的 元 素 个 数 

len = a.GetLength(1); 

Console. WriteLine( $ "第 二 维度 有 {len} 个 元 素 。"); 
// 获取 第 三 维度 的 元 素 个 数 

len = a.GetLength(2); 

Console. WriteLine( $ "第 三 维度 有 {1en} 个 元 素 。"); 


步骤 4: 输出 整个 数组 的 元 素 总 数 。 


图 6-8 输出 数组 中 各 
Console. WriteLine( $ "整个 数组 共有 {a. Length} 个 元 素 。"); 维度 的 元 素数 量 


步骤 5: 运行 应 用 程序 ,输出 信息 如 图 6-8 所 示 。 
实例 172 ”动态 调整 数组 的 大 小 


【导语 】 

Array 类 有 一 个 静态 方法 名 为 Resize, 其 方法 格式 如 下 。 

static void Resize <T>(ref T[ ] array, int newSize); 

它 是 一 个 泛 型 方法 ,类 型 参数 T 指定 数组 元 素 类 型 ,newSize 参数 设 定数 组 的 新 容量 。 
实际 上 ,数组 实例 一 旦 初始 化 , 它 的 大 小 是 固定 的 ,不 可 修改 。Resize 方法 的 实现 原理 是 创 
建新 的 数组 实例 ,并 将 大 小 设置 为 newSize, 然 后 把 array 中 现 有 的 元 素 复 制 到 新 实例 中 ,并 
通过 引用 (参数 带 有 ref 修饰 符 ) 让 array 参数 引用 新 创建 的 数组 实例 ,这 样 就 达到 了 动态 调 
整数 组 大 小 的 目的 。 因 此 ,调整 数组 大 小 后 就 创建 了 一 个 全 新 的 实例 , 原 有 的 实例 被 丢弃 。 
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【操作 流程 】 
步骤 1: 创建 控制 台 应 用 项 目 。 
步骤 2: 声明 一 个 double 类 型 的 数组 ,并 进行 赋值 。 


double[ ] arr = { 0.001d, 0.000025d, 0.3135d }; 


步骤 3: 上 面 数组 实例 包含 3 个 元 素 , 大 小 为 3。 现 
在 把 数组 大 小 改 为 5。 


Array. Resize(ref arr, 5); 


步骤 4: 运行 应 用 程序 ,控制 台 输 出 内 容 如 图 6-9 
所 示 。 

实例 173 反 转 数组 

【导语 】 

Reverse 方法 支持 将 数组 中 元 素 的 顺序 反 转 。 反 转 是 基于 数组 元 素 的 当前 顺序 ,例如 

-个 整 型 数组 的 当前 顺序 为 1、2、3, 那 么 反 转 后 的 顺序 为 3、2,1。 

反 转 可 分 为 两 种 情况 : 一 种 是 把 数组 中 所 有 元 素 的 顺序 反 转 ; 另 一 种 是 把 数组 中 部 分 
元 素 的 顺序 反 转 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 实例 化 一 个 字符 串 数组 。 


图 6-9 数组 大 小 调整 前 后 的 对 比 


string[ ] a = { "ab”, "cd", "ef”, "gh" }; 
步骤 3: 对 以 上 数组 中 的 所 有 元 素 进行 全 部 反 转 。 
Array. Reverse(a); 
步骤 4: 再 创建 一 个 int 数组 。 
i 
步骤 5: 对 以 上 数组 进行 部 分 反 转 ,从 第 4 个 元 素 开 始 , 反 转 4 个 元 素 。 
Array. Reverse(b, 3, 4); 
CAProgram Files\dotnet\domet. — 口 x 第 4 个 元 素 是 3, 从 此 处 起 连续 4 个 元 素 , 即 
3、4、5、6, 把 它们 反 转 后 就 是 6、5、4、3, 而 0、1、2、 
7、8 这 几 个 元 素 的 位 置 是 不 变 的 ,因此 反 转 后 的 
数组 应 为 0、1、2、6、5、4、3、7、8。 

步骤 6: 运行 应 用 程序 ,输出 内 容 如 图 6-10 
图 6-10 数组 反 转 前 后 对 比 所 示 。 


实例 174 查找 符合 条 件 的 元 素 


【导语 】 

有 两 种 方法 可 以 查找 数组 中 满足 特定 条 件 的 元 素 。 

第 一 种 方法 是 查找 单个 元 素 。 执 行程 序 会 逐一 验证 数组 中 的 元 素 ,一 旦 遇 到 符合 条 件 
的 元 素 ,就 马上 将 该 元 素 返 回 。 无 论 数 组 中 有 多 少 个 元 素 符合 查找 条 件 ,代码 只 会 返回 第 一 
个 找到 的 元 素 。 这 种 查找 方式 可 以 调用 Find 方法 完成 。 

第 二 种 方法 是 把 数组 中 所 有 符合 条 件 的 元 素 重新 组 合 为 一 个 新 的 数组 实例 ,并 返回 给 
代码 调用 者 。 这 种 方式 可 以 通过 调用 FindAll 方法 来 完成 。 

不 论 是 Find 方法 还 是 FindAll 方法 ,都 带 有 一 个 委托 类 型 的 参数 一 一 Predicate, 该 委 
托 的 定义 如 下 。 


delegate bool Predicate< in T>(T obj) 


输入 参数 obj 可 通过 泛 型 参数 来 确定 类 型 .在 与 该 委托 绑 定 的 方法 中 .开发 人 员 可 以 根 
据 实际 需求 编写 代码 ,对 obj 参数 传递 的 对 象 进行 验证 ,如 果 符 合 条 件 就 返回 true. 和 否则 返 
回 false。 

在 Find 方法 或 者 FindAll 方法 中 ,执行 程序 会 为 数组 中 的 每 个 元 素 调 用 一 次 Predicate 实 
例 .并 把 此 元 素 传 递 给 obj 参数 。 只 要 调用 委托 的 结果 返回 true, 就 表示 它 就 是 要 查找 的 元 素 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 WorkItem 类 ,假设 它 表 示 某 个 生产 过 程 中 一 道 工序 的 基本 信息 。 


public class WorkItem 

{ 
public int ID { get; set; } 
public string Title { get; set; } 
public DateTime StartTime { get; set; } 
public DateTime EndTime { get; set; } 


} 


其 中 ,StartTime 属性 表示 工序 的 开始 时 间 ,EndTime 属性 表示 工序 的 结束 时 间 。 
步骤 3: 实例 化 一 个 WorkItem 数组 ,并 填充 6 个 元 素 , 详 见 代码 清单 6-2。 


代码 清单 6-2 ”初始 化 WorkItem 数组 


WorkItem[ ] items = 
{ 
new WorkItem 
{ 
ID = 1， 
Title = "工序 1"， 
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StartTime = new DateTime(2018,7,1,8,36,0), 
EndTime = new DateTime(2018,7,2,17,30,0) 
}, 
new WorkIten 
{ 
ID=2, 
Title = "工序 2"， 
StartTime = new DateTime(2018, 7, 2, 10, 15, 0), 
EndTime = new DateTime(2018, 7, 5, 18, 0, 0) 
}， 
new WorkIten 
. 
ID = 3, 
Title = "工序 3"， 
StartTime = new DateTime(2018, 7, 1, 15, 25, 0), 
EndTime = new DateTime(2018, 7, 12, 17, 0, 0) 
]， 
new WorkIten 
{ 
ID=4, 
Title = "工序 4"， 
StartTime = new DateTime(2018, 7, 14, 9, 16, 0), 
EndTime = new DateTime(2018, 7, 20, 8, 20, 0) 
}, 
new WorkIten 
{ 
ID = 5 
Title = "工序 5"， 
StartTime = new DateTime(2018, 7, 23, 9, 10, 0), 
EndTime = new DateTime(2018, 7, 28, 15, 32, 0) 
}, 
new WorkIten 
. 
ID=6, 
Title = "工序 6"， 
StartTime = new DateTime(2018, 7, 18, 9, 11, 0), 
EndTime = new DateTime(2018, 7, 25, 16, 45, 0) 


}; 


步骤 4: 查找 开始 时 间 晚 于 2018 年 7 月 15 日 的 工序 。 此 处 使 用 Find 方法 ,虽然 原来 
的 数组 中 有 多 个 元 素 符 合 条 件 , 但 只 返回 最 先 找到 的 那个 。 


互 


WorkItem res = Array.Find(items, i => 
和 
DateTime condition = new DateTime(2018, 7, 15); 
if (i.StartTime > condition) 
return true; 
return false; 


D; 
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实例 175 ”查找 符合 条 件 的 元 素 的 索引 


【导语 】 

Find 与 FindAll 方 法 是 直接 查找 元 素 并 将 其 返回 ,但 有 些 时 候 ,并 不 需要 知道 要 查找 的 
元 素 内 容 , 而 仅仅 需要 知道 其 所 在 位 置 ( 即 索引 ) 。 

FindIndex 与 FindLastIndex 方法 支持 对 数组 中 的 元 素 进 行 查找 ,找到 后 返回 元 素 的 索 
引 。 两 个 方法 的 不 同 点 在 于 : FindIndex 方法 只 返回 符合 条 件 的 第 一 个 元 素 的 索引 ,而 
FindLastIndex 方法 则 返回 符合 条 件 的 最 后 一 个 元 素 的 索引 。 如 果 找 不 到 符合 条 件 的 元 素 ， 
这 两 个 方法 都 会 返回 一 1。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 一 个 字符 串 数 组 ,并 初始 化 。 


string[ ] src = 
{ 
"page", 
"food", 
"make", 
good", 
"sleep” 


于 


步骤 3: 使 用 FindIndex 方法 查找 以 上 数组 中 含有 字母 a 的 元 素 ,并 返回 第 一 个 符合 条 
件 的 元 素 的 索引 。 


int index = Array.FindIndex(src, i => 
{ 
if (i.Contains("a")) 
return true; 
return false; 
D); 
Console. WriteLine( "找到 包含 字母 "a" 的 首 个 元 素 的 索引 :{0}"，index); 


步骤 4: 同样 ,查找 含有 字母 a 的 元 素 , 但 返回 符合 条 件 的 最 后 一 个 元 素 的 索引 。 


int lastindex = Array.FindLastIndex(src, i => 
{ 
if (i.Contains("a")) 
return true; 
return false; 
]) 
Console. WriteLine( "找到 包含 字母 "a" 的 最 后 一 个 元 素 的 索引 : {0}"，lastindex); 


步骤 5: 运行 应 用 程序 ,输出 结果 如 图 6-12 所 示 。 
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图 6-12 查找 带 字母 a 的 元 素 索引 


实例 176 ”确定 数组 中 元 素 的 存在 性 
【导语 】 


确定 元 素 的 存在 性 与 查找 元 素 不 同 , 因 为 不 需要 获得 元 素 的 相关 信息 ,只 需要 确定 数组 
中 是 否 包含 某 个 元 素 。 

判断 数组 中 是 否 存 在 满足 条 件 的 元 素 , 可 以 调用 Exists 方法 ,如 果 存 在 符合 条 件 的 元 
素 ,该 方法 返回 true ,否则 返回 false。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 项 目 。 

步骤 2: 声明 一 个 Student 类 。 


public class Student 

{ 
public string Name { get; set; } 
public string City { get; set; } 
public string Course { get; set; } 


} 
步骤 3: 创建 一 个 Student 数组 ,并 填充 一 些 Student 对 象 。 


Student[] stus = 
{ 
new Student 
{ 
Name = "小 曹 "， 
Course = "OCH" 
City = “广州” 
}, 
new Student 
{ 
Name = "小 王 "， 
Course = "PhotoShop", 
City = "成 都 " 
)} 
new Student 
和 
Name =“" 小 刘 "， 
Course = "VB", 
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City = "天 津 " 
} 
}; 
步骤 4: 调用 Exists 方法 确认 以 上 数组 中 是 否 存 在 来 自重 庆 的 学 员 . 即 Student 对 象 的 
City 属性 是 否 为 “重庆 ”。 


bool res = Array. Exists(stus, x => x.City == "重庆 "); 
if (res) 

Console. WriteLine(" 存 在 来 自重 庆 的 学 员 。"); 
else 


Console. WriteLine(" 不 存在 来 自重 庆 的 学 员 ,"); 
上 述 数 组 实例 中 并 没有 City 属性 为 “重庆 ”的 Student 实例 ,因此 Exists 方法 返回 
false, 即 不 存在 符合 条 件 的 元 素 。 
实例 177 复制 数组 中 的 元 素 


本 实例 将 演示 如 何 将 一 个 数组 对 象 中 的 部 分 元 素 复制 到 另 一 个 数组 对 象 中 ,其 中 用 到 
了 以 下 重 载 版 本 的 Copy 方法 (Array 类 公开 的 静态 方法 )。 


static void Copy (Array sourceArray, int sourceIndex, Array destinationArray, int 
destinationIndex, int length); 
sourceArray 表示 来 源 数组 ,方法 要 从 该 数组 中 复制 元 素 ; destinationArray 表示 目标 
数组 ,要 接收 被 复制 元 素 ; sourceIndex 是 来 源 数组 中 要 开始 进行 复制 的 元 素 索引 ; 
destinationIndex 是 目标 数组 中 要 开始 写 入 被 复制 元 素 的 索引 ， length 是 要 复制 元 素 的 


个 数 。 
【操作 流程 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 创建 一 个 int 数组 ,作为 来 源 数组 。 


tarrl = 有 

步骤 3: 创建 第 二 个 数组 对 象 , 它 只 能 容纳 3 个 元 素 。 

int[] arr2 = new int[3]; 

步骤 4: 从 arrl 数组 中 复制 4.5.6 到 arr2 数组 中 

Array. Copy(arr1，3，arr2，0，3); 

在 arrl 数组 中 ,元素 4 的 索引 为 3, 因 此 在 调用 Copy 方法 时 ,sourceIndex 参数 应 该 传 
递 数 型 值 3。 在 arr2 数组 中 ,从 第 一 个 索引 开始 存放 复制 过 来 的 元 素 ,destinationIndex 参 
数 的 值 应 为 0。 

步骤 5: 分 别 输出 两 个 数组 中 的 元 素 进行 对 比 。 
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Console. WriteLine( $ "来 源 数组 :{string.Join(',', arr1)}"); 
Console. WriteLine( $ "目标 数组 :{string. Join(',', arr2)}"); 
步骤 6: 运行 应 用 程序 ,得 到 的 输出 结果 如 下 。 
来 源 数组 :1,2,3,4,5,6 


目标 数组 :4,5,6 

6.3 集合 
实例 178 ”将 数字 进行 降序 排列 
【导语 】 


标准 的 排序 方案 为 : 数字 从 小 到 大 ( 即 升序 ) ,字母 从 A 到 Z( 或 从 a 到 z)。 如 果 要 让 数 
字 从 大 到 小 排序 ( 即 降序 ) ,可 以 尝试 用 比较 器 实现 。 

比较 器 可 以 分 析 两 个 对 象 之 间 的 差异 ,一般 返回 一 个 整数 值 ,如 果 该 值 等 于 0, 表示 两 
个 对 象 相等 ; 如 果 该 值 大 于 0, 表 示 对 象 A 比 对 象 B 要 大 ; 如 果 该 值 小 于 0, 表 示 对 象 A 比 
对 象 B 要 小 。 

有 两 个 与 实现 自 定义 比较 相关 的 接口 : IComparer 接口 面向 Object 类 型 ; IComparer < 全 > 
接口 带 类 型 参数 ,可 以 更 好 地 控制 要 进行 比较 的 类 型 。 

不 过 ,在 实战 阶段 ,开发 者 可 以 不 直接 实现 以 上 两 个 接口 ,而 是 考虑 从 Comparer< 工 > 
类 派生 。Comparer < 了 > 是 抽象 类 ,派生 时 必须 实现 Compare 方 法 ,原型 如 下 。 


int Compare(T x, T y) 


类 型 下 是 个 类 型 参数 ,可 用 实际 类 型 替换 。 

通过 访问 Default 静态 属性 ,也 可 以 获得 标准 (默认 ) 的 比较 器 。 当 数值 A 大 于 数值 B 
时 ,返回 大 于 0 的 整数 ; 当 数 值 A 小 于 数值 B 时 ,返回 小 于 0 的 整数 ,该 方法 默认 以 升序 排 
列 。 所 以 要 想 实现 降序 排列 ,只 要 反 过 来 即 可 : 当 数值 A 大 于 数值 B 时 ,返回 小 于 0 的 整 
数 ; 当 数 值 A 小 于 数值 B 时 ,返回 大 于 0 的 整数 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 从 Comparer< 工 > 派生 出 一 个 自 定义 的 比较 器 ,因为 本 实例 是 针对 int 类 型 数 
值 进 行 处 理 ,T 的 类 型 为 int。 


public class MyComparer : Comparer < int> 
{ 
public override int Compare( int x, int y) 
{ 
return — (x 一 y); 


F 
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Compare 方法 的 实现 很 简单 ,直接 将 两 个 数值 相 减 ,然后 在 前 面 加 上 一 个 负 号 (一 ) 即 
可 。 加 上 负 号 之 后 ,本 来 大 于 0 的 值 就 会 变 成 小 于 0, 本 来 小 于 0 的 值 就 会 大 于 0, 这 就 达到 
反 向 排序 的 效果 了 。 

步骤 3: 此 处 使 用 SortedSet < 全 > 集合 来 做 演示 ,只 要 往 这 个 类 里 面 添加 元 素 就 会 自动 
排序 ,不 需要 去 调用 Sort 方 法。 在 初始 化 时 ,需要 将 上 述 自 定义 的 MyComparer 比较 器 实 
例 传 递 给 构造 函数 ,否则 它 只 会 按 默 认 规则 排序 。 


SortedSet < int > list = new SortedSet < int >(new MyConparer()); 
步骤 4: 向 集合 添加 5 个 整数 值 。 


list.Add(15); 
list. Add(2); 
list. Add(25); 
list.Add(13); 
list.Add(7); 


步骤 5: 为 了 验证 是 否 自动 进行 降序 排列 ,可 以 将 集合 中 的 元 素 输 出 到 控制 台 。 


foreach (int x in list) 
{ 


Console. WriteLine(x); 


} 
步骤 6: 运行 应 用 程序 ,控制 台 输出 内 容 如 下 。 


实例 179 初始 化 List < 工 > 集合 


【导语 】 

List< 工 > 类 是 泛 型 类 , 带 有 类 型 参数 ,所 以 它 表 示 的 是 一 种 强 类 型 的 集合 ,并 且 支 持 动 
态 添 加 删除 .修改 ,查找 元 素 等 操作 。 

在 实例 化 List< 工 > 对 象 时 ,可 以 创建 一 个 空 的 列表 ,然后 往 里 面 添加 元 素 , 例如 调用 
Add 或 AddRange 方 法 。 每 次 调用 Add 方法 只 能 添加 一 个 元 素 ,而 调用 AddRange 方法 可 
以 一 次 性 添加 多 个 元 素 , 也 可 以 将 其 他 集合 (例如 数组 ) 的 元 素 加 进去 。 

也 可 以 把 另 一 个 集合 实例 (实现 了 IEnumerable < out T > 接口 的 均 可 ) 传递 给 
List < 本 > 的 构造 函数 来 初始 化 ,调用 构造 函数 后 会 自动 将 另 一 个 集合 的 元 素 添加 到 当前 列 
表 中 。 
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【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 System. Collections. Generic 命名 空间 ,许多 泛 型 集合 相关 的 类 型 都 在 这 
个 命名 空间 下 。 

using System, Collections. Generic; 

步骤 3: 实例 化 一 个 空白 的 列表 。 

List<int>1a = new List<int>(); 

步骤 4: 调用 3 次 Add 方 法 ,添加 3 个 元 素 。 


la. Add(5); 
la. Add(6); 
la. Add(7); 


步骤 5: 调用 AddRange 方 法 ,把 一 个 数组 实例 中 的 3 个 元 素 也 添加 进 当 前 列表 中 。 


int[l]a = 123,39, 3 }; 
la. AddRange(a); 


步骤 6: 输出 la 列表 中 所 有 元 素 。 此 时 la 列表 中 应 有 6 个 元 素 。 


Console.WriteLine(" 第 一 个 列表 中 的 元 素 :"); 
foreach (int n in 1a) 


{ 
Console. Write(" {0}", n); 


} 

步骤 7: 实例 化 第 二 个 列表 ,并 且 把 上 述 la 列表 实例 传递 给 构造 函数 , 即 lb 列表 初始 化 
后 就 带 有 6 个 元 素 了 。 

List<int> lb = new List< int >(1a); 

步骤 8: 再 向 lb 列表 中 添加 2 个 元 素 。 


1b. Add( 100); 
1b. Add( 600); 


步骤 9: 输出 lb 列表 中 的 元 素 。 此 时 lb 列表 中 应 有 8 个 元 素 。 
Console. WriteLine("\n\n 第 二 个 列表 中 的 元 素 :"); 


foreach (int n in 1b) 


{ 


Console. Write(" {0}", n); 


} 
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步骤 10: 运行 应 用 程序 ,输出 结果 如 图 6-13 所 示 。 


6-13 输出 la 和 lb 列表 的 元 素 


实例 180 ”实现 IEnumerator 接口 


【导语 】 

IEnumerator 接口 位 于 System. Collections 命名 空间 下 , 它 的 作用 是 对 集合 元 素 进 行 枚 
举 。 在 实现 该 接口 时 ,主要 实现 以 下 两 个 成 员 : 

(1) Current 属性 : 获取 当前 位 置 的 元 素 。IEnumerator 在 枚 举 集合 元 素 时 只 会 一 路 向 
前 ,从 第 一 个 元 素 到 最 后 一 个 元 素 ,逐个 列举 ,并 且 是 只 读 的 。 也 就 是 说 ,在 枚 举 元 素 的 过 程 
中 ,不 能 对 集合 进行 修改 (不 能 添加 、 删 除 或 替换 元 素 ) 。 

(2) MoveNext 方 法 : 这 个 方法 是 完成 枚 举 逻 辑 的 核心 ,必须 实现 。 在 IEnumerator 初 
始 化 时 ,必须 将 当前 位 置 放 到 所 有 元 素 之 前 (如 果 要 枚 举 集合 对 象 , 可 以 将 索引 定位 为 一 1)， 
Current 属性 也 要 初始 化 为 默认 值 ,例如 null( 引 用 类 型 ) 或 者 0( 值 类 型 )。 当 调用 
MoveNext 方法 时 , 枚 举 器 向 前 位 移 一 个 位 置 ,并 把 下 一 个 元 素 赋值 给 Current 属性 。 成 功 
枚 举 元 素 后 返回 true, 如 果 已 经 到 了 集合 的 末尾 或 者 无 法 再 往 下 枚 举 , 需 要 返回 false。 

还 有 一 个 Reset 方法 ,此 方法 只 用 于 COM 互 操作 。 如 果 代 码 中 不 使 用 COM 互 操作 ， 
此 方法 可 以 保留 空白 (不 添加 任何 实现 代码 ) 。 

从 IEnumerator 接口 还 引申 出 一 个 IEnumerator< T > 接口 ,声明 如 下 : 


public interface IEnumerator < out T> : IEnumerator，IDisposable 


它 是 一 个 泛 型 接口 , 带 有 输出 参数 T( 协 变 ) ,并 继承 了 IEnumerator 接口 的 成 员 , 同 时 包含 
IDisposable 接口 的 成 员 。IDisposable 接口 有 一 个 Dispose 方法 ,实现 它 可 以 在 对 象 实例 被 
销毁 时 释放 相关 的 资源 (例如 对 文件 句柄 的 引用 ) 。 

IEnumerator< 工 > 接口 也 存在 一 个 与 IEnumerator 接口 同名 的 属性 一 一 Current, 但 它 
的 类 型 不 是 Object, 而 是 由 类 型 参数 T 指定 的 类 型 。 因 此 当 实 现 IEnumerator < 本 > 接口 
时 ,可 以 先 实现 该 接口 的 Current 属性 ,然后 显 式 实现 Enumerator 接口 的 Current 属性 ,这 
样 可 以 避免 同名 成 员 的 冲突 。 

本 实例 将 演示 一 个 实现 Enumerator < 本 > 接口 的 自 定义 类 , 它 将 枚 举 出 10 个 随机 生 
成 的 整数 。 当 已 产生 的 整数 超过 10 个 时 ,MoveNext 方法 返回 false。 

【操作 流程 】 

步骤 1: 在 Visual Studio 中 创建 一 个 控制 台 应 用 程序 项 目 。 


步骤 2: 引入 以 下 两 个 命名 空间 。 


using System. Collections; 


using System. Collections. Generic; 
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步骤 3: 声明 一 个 实现 了 IEnumerator < 了 > 的 类 ,其 中 用 int 替换 类 型 下 。 详 见 代 码 清 
单 6-3。 


代码 清单 6-3 MyEnumerator 类 的 完整 代码 


public class MyEnumerator : IEnumerator < int > 


{ 


Random rand = null; 
int count; 


public MyEnumerator( ) 
{ 
rand = new Random(); 
count = 0; 
Current = default(int); 
} 


public int Current { get; private set; } 


object IEnumerator.Current 
{ 

get { return Current; } 
} 


public void Dispose() 
{ 
rand = null; 


} 


public bool MoveNext() 
{ 
if (++count > 10) 
return false; 
Current = rand. Next(); 
return true; 


上 


public void Reset() 
下 
count = 0; 
Current = default(int); 


在 MyEnumerator 类 的 构造 函数 中 ,对 相关 成 员 进 行 初始 化 。rand 字段 引用 了 
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Random 类 实例 ,负责 产生 随机 整数 ,该 实例 可 在 Dispose 方法 中 销毁 引用 ( 即 给 变量 赋值 
null 引用 ) ,也 可 以 不 处 理 ,运行 时 会 自行 清理 。count 字段 用 来 存放 已 经 枚 举 的 整数 数量 ， 
初始 化 时 为 0, 每 产生 一 个 整数 值 就 会 加 上 1。 

在 MoveNext 方 法 中 , 先 将 count 字段 加 上 1, 如 果 加 1 后 大 于 10, 直 接 返 回 false, 不 需 
要 枚 举 项 目 了 ; 否则 产生 新 的 随机 数 , 并 赋值 给 Current 属性 ,最 后 返回 true。 

Reset 方法 不 是 必需 的 ,可 以 保留 但 不 编写 实现 代码 , 它 主要 用 于 COM 交互 ,此 处 将 
count 字段 与 Current 属性 的 值 还 原 为 默认 值 。 

步骤 4: 在 Main 方法 中 ,实例 化 MyEnumerator 类 。 


MyEnumerator et = new MyEnumerator(); 


步骤 5: 通过 循环 调用 MoveNext 方法 枚 举 出 所 有 随机 产生 
的 整数 ,直到 它 返 回 false。 


while (et. MoveNext()) 
{ 


Console. WriteLine(et. Current); 


; 图 6-14 枚 举 出 的 

步骤 6: 运行 应 用 程序 ,上 述 代码 所 枚 举 的 10 个 随机 整数 如 10 个 整数 
图 6-14 所 示 。 

实例 181 IEnumerable 接口 与 foreach 循环 

【导语 】 


若 某 个 集合 类 型 实现 了 IEnumerable 接口 ,就 可 以 使 用 foreach 循环 语句 对 其 进行 枚 

举 。IEnumerable 接口 只 有 一 个 方法 一 一 GetEnumerator ,该 方法 被 调用 后 会 向 调用 方 返回 
-个 实现 了 IEnumerator 接口 的 类 型 实例 ,然后 程序 代码 就 可 以 通过 MoveNext 方法 ,并 配 
合 使 用 Current 属性 来 逐一 获取 集合 中 的 元 素 。 

常用 的 集合 类 型 如 SortedList、Hashtable、Queue 等 都 实现 了 IEnumerable 接口 ,因此 
可 以 直接 使 用 foreach 循环 枚 举 其 中 的 元 素 。 

本 实例 将 演示 一 个 自 定义 类 ,该 类 实现 了 IEnumerable 接口 ,并 且 该 类 中 包含 一 个 
string 类 型 的 数组 。GetEnumerator 方法 返回 用 于 枚 举 string 数组 的 对 象 实例 ,该 实例 的 
类 型 实现 了 IEnumerator 接口 ,可 以 通过 它 的 MoveNext 方法 向 前 移动 要 访问 的 索引 位 置 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 首先 声明 一 个 实现 了 IEnumerator 接口 的 类 , 它 的 功能 是 配合 MoveNext 方法 
与 Current 属性 来 枚 举 string 数组 中 的 元 素 。 为 了 能 访问 到 相关 数组 ,该 类 的 构造 函数 带 
有 一 个 接收 string 数组 类 型 的 参数 。 详 见 代码 清单 6-4。 


代码 清单 6-4 MyEnumerator 类 的 完整 代码 


internal class MyEnumerator : IEnumerator 
{ 

string[ ] _arr; 

int _currentIndex; 


public MyEnumerator( string[ ] src) 
{ 
_arr = src; 


_currentIndex = —1; 


public object Current { get; private set; } 


public bool MoveNext( ) 
{ 
// 如 果 当 前 位 置 已 超出 索引 的 最 大 值 , 就 返回 false 


if(++_currentIndex > = _arr. Length) 


{ 
Current = null; 
return false; 
} 
Current = arr[_currentIndex]; 


return true; 


public void Reset() 
下 
throw new NotImplementedException( ); 


q 
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注意 : IEnumerator 只 能 向 前 读 取 , 不 能 循环 读 取 。 也 就 是 说 , 当 要 读 取 元 素 的 索引 已 经 超 
出 数组 的 大 小 后 ,必须 使 MoveNext 方法 返回 false, 不 能 重新 回 到 集合 的 开始 位 置 。 


Reset 方法 可 以 不 添加 实现 代码 。 


步骤 3: 声明 一 个 模拟 集合 类 ,实现 IEnumerable 方法 。 


public class MyExampleCollection : IEnumerable 
{ 


string[ ] arraySrc = { "red", "blue", "green", "gray" }; 


public IEnunerator GetEnumerator() 
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return new MyEnumerator (arraySrc); 


. 


GetEnumerator 方法 将 返回 刚才 声明 的 MyEnumerator 类 实例 。 
步骤 4: 回 到 Main 方法 , 先 创建 一 个 新 的 MyExampleCollection 实例 。 


MyErampleCollection en = new MyExempleCollection(); 
步骤 5: 此 时 可 以 使 用 foreach 循环 语句 直接 对 pe 
MyExampleCollection 实例 进行 枚 举 。 gg 


foreach(var iten in en) 


{ 


Console. WriteLine( item) ; 
图 6-15 ”循环 列 出 四 个 字符 串 实例 
步骤 6: 运行 应 用 程序 项 目 ,输出 的 结果 如 图 6-15 
所 示 。 


实例 182 IEnumerable <T> 与 foreach 循环 


【导语 】 

IEnumerable 接口 只 能 针对 Object 类 型 进行 处 理 ,在 使 用 foreach 循环 时 也 是 默认 以 
Object 类 型 访问 。 因 此 在 枚 举 集合 元 素 时 常常 要 进行 类 型 转换 ,而 这 些 类 型 转换 多 数 情况 
下 是 不 必要 的 ,频繁 进行 类 型 转换 对 应 用 程序 的 性 能 也 有 负面 影响 。 

为 了 解决 以 上 问题 , 便 衍生 出 IEnumerable< T > 接口 ,声明 如 下 。 


interface IEnumerable< out T> : IEnumerable 


从 接口 的 声明 可 以 看 出 , 它 也 包含 了 IEnumerable 接口 的 成 员 。IEnumerable < T > 接 
口 还 重新 定义 了 GetEnumerator 方法 ,使 其 所 返回 的 对 象 也 支持 泛 型 。 


TEnumerator <T> GetEnumerator(); 


有 了 类 型 参数 工 ,就 可 以 限制 集合 的 类 型 ,而 不 再 是 默认 的 Object, 可 以 在 一 定 程度 上 
避免 了 过 多 的 类 型 转换 。 在 使 用 foreach 循环 语句 枚 举 元 素 时 也 可 以 做 到 强 类 型 。 

本 实例 以 decimal 类 型 蔡 换 类 型 参数 本 ,实现 IEnumerable < 下 > 接口 。 当 用 foreach 语 
句 枚 举 元 素 时 ,临时 变量 可 以 直接 表示 为 decimal 类 型 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 为 了 方便 调用 , 先 实现 IEnumerator < 本 > 接口 ,TT 为 decimal。 详 见 代码 清单 6-5。 


第 6 章 
代码 清单 6-5 NumberEnumerator 类 的 完整 代码 
internal class NumberEnumerator : IEnumerator < decimal > 
{ 
decimal[ ] srcNumbers; // 来 源 数 组 
int currentIndex; // 当 前 元 素 的 索引 
public NumberEnumerator(decimal[ ] source) 
{ 
srcNumbers = source; 
currentIndex = —1; // 索 引 位 于 第 一 个 元 素 之 前 


public decimal Current { get; private set; } 


// 显 式 实现 IEnumerator 接口 的 Current 属性 


object IEnumerator.Current => Current; 


public void Dispose() 
{ 


public bool MoveNext() 
未 
// 如 果 索 引 超出 范围 
ifE(++currentIndex > = srcNumbers.Length) 
{ 
Current = default; 
return false; 
} 
// 获取 当前 索引 处 的 元 素 
Current = srcNumbers[currentIndex]; 
return true; 


public void Reset() 
{ 


此 处 Reset 和 Dispose 方法 可 以 保留 空白 方法 体 。 
步骤 3: 实现 IEnumerable< 工 >,T 为 decimal。 


public class Numbers : IEnumerable< decimal > 
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decimal[ ] numberarr = { 7.33M, 16.12M, 800.56M, 1202.633M, 170.9M }; 


public IEnunerator < decimal > GetEnumerator( ) 


{ 


return new NumberEnumerator (numberarr) ; 


} 


// 显 式 实现 IEnumerable 接口 的 GetEnumerator 方法 
IEnumerator IEnumerable. GetEnumerator( ) 
{ 
return GetEnumerator( ); 
} 
} 


步骤 4: 回 到 Main 方法 ,创建 Numbers 实例 。 

Numbers nbs = new Numbers(); 

步骤 5: 使 用 foreach 语句 枚 举 元 素 , 临 时 变量 可 以 直接 声明 
为 decimal 类 型 。 


foreach (decimal n in nbs) 


{ 


图 6-16 foreach 循环 枚 
举 出 来 的 数值 


Console. WriteLine(" {0:G}", n); 


} 
步骤 6: 运行 应 用 程序 ,控制 台 输出 结果 如 图 6-16 所 示 。 


实例 183 IEnumerable 接口 与 yield return 语句 


【导语 】 

yield return 语句 比较 有 趣 , 它 可 以 在 一 个 方法 (get 访问 器 或 运算 符 ) 中 返回 多 个 值 (每 
条 yield return 语句 返回 一 个 值 ,但 可 以 多 次 使 用 ) .这些 返回 值 会 被 隐 式 地 组 成 一 个 集合 实 
例 ( 迭 代 器 )。 因 此 ,包含 yield return 语句 的 成 员 , 其 返回 类 型 必须 是 IEnumerable 或 者 是 
TIEnumerable <T>., 

无 须 显 式 地 编写 新 类 来 实现 IEnumerable 或 者 是 IEnumerable < 全 > 接口 ,仅仅 将 接口 
类 型 作为 返回 类 型 即 可 ,运行 时 会 隐 式 创建 集合 。 如 果 返 回 的 类 型 是 IEnumerable 接口 ,那么 
使 用 foreach 语句 枚 举 出 来 的 元 素 默 认为 object 类 型 。 如 果 返 回 的 类 型 是 IEnumerable < > 
接口 ,那么 foreach 语句 枚 举 出 来 的 类 型 就 是 类 型 参数 工 的 具体 类 型 。 例 如 ,返回 类 型 为 
IEnumerable< int >, 那 么 在 使 用 foreach 语句 时 , 枚 举 出 来 的 元 素 为 int 类 型 。 

代码 逻辑 在 使 用 foreach 循环 进行 迭代 时 ,会 将 每 一 条 yield return 语句 后 的 元 素 依 次 
返回 ,其 间 如 果 想 终止 迭代 ,可 以 使 用 如 下 yield break 语句 。 


Yield break; 


第 6 章 ” 泛 型 与 集合 | 做 219 


【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 项 目 模板 生成 的 Program 类 中 定义 一 个 静态 方法 , 返回 类 型 为 
IEnumerable, 在 方法 体 中 ,依次 返回 3 个 int 数值 。 


static IEnumerable Testl() 


{ 
Yield return 0; 
Yield return 1; 
Yield return 2; 
} 


步骤 3: 再 在 Program 类 中 定义 一 个 静态 方法 ,此 次 返回 类 型 为 [Enumerable < string >， 
方法 依次 返回 3 个 字符 串 实例 。 


static IEnumerable< string> Test2() 


{ 
Yield return "abcd"; 
Yield return "opqrs"; 
yield return "@# $% "; 
} 


步骤 4: 在 Main 方法 中 , 先 调 用 Testl 方法 ,并 与 foreach 循环 一 起 使 用 , 枚 举 其 返回 
的 内 容 。 


foreach (var item in Test1()) 
{ 
Console. WriteLine( item); 


} 
步骤 5: 用 同样 的 方式 调用 Test2 方法 。 


foreach (var item in Test2()) 


{ 
Console. WriteLine( item); 
} 
以 上 两 个 foreach 循环 中 ,都 用 var 关键 字 来 声明 临时 变量 item, 目 的 是 让 编译 器 自动 
推断 类 型 。 
如 图 6-17 所 示 ,把 鼠标 指针 移 到 枚 举 Testl 方法 返回 结果 的 item 变量 上 ,从 智能 提示 


可 以 看 到 ,item 变量 被 推断 为 object 类 型 。 
foreach (var item in Test1()) 


{ PR en 
| 


Console. WriteLine (item) ; 


| 
图 6-17 智能 提示 显示 为 object 类 型 
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在 枚 举 Test2 方法 返回 结果 的 代码 中 ,item 变量 被 推断 为 string 类 型 ,如 图 6-18 所 示 。 


each (var item in Test2()) 


Console. WriteLine (item) ; 


图 6-18 智能 提示 显示 为 string 类 型 


实例 184 ”无 重复 元 素 的 集合 


【导语 】 

HashSet < 全 > 是 一 个 泛 型 集合 ,与 其 他 集合 类 相 比 , 它 有 一 个 明显 的 特征 一 一 该 集合 
不 能 包含 重复 的 元 素 。 当 调用 Add 方法 向 集合 中 添加 元 素 后 会 返回 一 个 布尔 值 ,如 果 成 功 
添加 就 返回 true; 如 果 在 集合 中 已 经 存在 要 添加 的 元 素 ,Add 方法 会 返回 false, 并 且 元 素 不 
会 被 添加 到 集合 中 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 创建 一 个 HashSet< 工 > 实例 ,类 型 工 为 int 类 型 。 


HashSet < int> set = new HashSet< int >(); 
步骤 3: 调用 3 次 Add 方法 向 集合 中 添加 元 素 , 并 对 方法 的 返 


// 不 重复 ,可 添加 
bool b = set. Add(1000); 
Console. WriteLine( "元素 {0} {1}。"，1000，b ? "添加 成 功 ”:" 未 添加 "); 


全 
本 
站 
当 


// 不 重复 ,可 添加 
b = set.Add(2000); 
Console.WriteLine(" 元 素 {0} {1}"，2000，b ? "添加 成 功 " : "未 添加 "); 


// 1000 已 经 存在 ,不 添加 

b = set.Add(1000); 

Console. WriteLine( "元素 {0} {1}"，1000, b ?" 添 加 成 功 ”:" 未 添加 "); 
因为 1000 与 2000 两 个 元 素 不 重复 ,所 以 能 成 功 添加 到 集合 
中 ; 当 再 次 添加 1000 时 ,由 于 元 素 已 经 存在 ,所 以 第 二 次 的 1000 
不 会 被 添加 。 


步骤 4: 运行 应 用 程序 ,输出 结果 如 图 6-19 所 示 。 图 6-19 集合 中 不 能 
有 重复 元 素 
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实例 185 ”双向 链表 


【导语 】 

LinkedList< 了 > 是 一 个 比较 有 趣 的 集合 , 它 属于 “双向 "链表 ,支持 如 下 操作 。 

(1) 在 列表 首部 插入 元 素 。 

(2) 在 列表 尾部 插入 元 素 。 

(3) 在 某 个 元 素 之 前 插入 元 素 。 

(4) 在 某 个 元 素 之 后 插入 元 素 。 

(5) 元 素 可 以 从 列表 中 移 除 , 也 可 以 重新 加 入 到 列表 的 任意 位 置 。 

LinkedList< 了 > 是 泛 型 集合 ,可 用 实际 类 型 替换 类 型 参数 T。 加 入 到 列表 中 的 元 素 都 
由 LinkedListNode < 了 > 对 象 进行 维护 , 称 为 结 点 。 当 元 素 被 移 除 之 前 ,可 以 通过 结 点 的 
Previous 属性 获得 当前 元 素 的 前 一 个 结 点 ,或 通过 Next 属性 获取 下 一 个 结 点 。 

每 个 LinkedListrNode < 了 > 实例 也 是 可 单独 维护 的 , 结 点 从 一 个 列表 中 移 除 并 添加 到 
另 一 个 列表 的 过 程 中 ,不 会 分 配 新 的 内 存 空间 。 访 问 Value 属性 可 以 获取 到 与 结 点 对 应 的 
元 素 值 。 

运用 LinkedList < 了 > 集合 类 ,可 以 对 元 素 进行 任意 顺序 “组 装 ”"”。 本 实例 将 演示 两 个 
LinkedList< 工 > 集 合 的 常规 用 法 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 实例 化 第 一 个 LinkedList 集合 。 


LinkedList < string> list = new LinkedList< string>(); 
步骤 3: 向 集合 中 添加 5 个 元 素 。 


// 添加 第 一 个 

var node = list.AddFirst(" 秦 "); 
// 跟随 其 后 

node = list,.AddAfter(node," 汉 "); 
// 同上 

node = list. AddAfter(node, " 隋 "); 
// 跟随 其 后 , 先 添加 " 宋 " 

node = 1list,Rddhfter(node，" 宋 "); 
// 再 在 " 宋 " 之 前 插 和 人" 唐 " 

list. AddBefore(node," 唐 "); 


添加 元 素 后 ,方法 会 返回 一 个 LinkedListrNode < 了 > 实例 ,以 便 调整 顺序 。 
步骤 4: 创建 第 二 个 LinkedList 实例 。 


LinkedList <byte> list2 = new LinkedList < byte>(); 


步骤 5: 在 列表 的 尾部 连续 追加 4 个 元 素 。 
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list2. AddLast (1); 
list2. AddLast (3); 
list2. AddLast (2); 
list2. AddLast (4); 


步骤 6: 此 时 ,集合 中 元 素 的 顺序 为 1.3、2、4, 接 下 来 把 3 和 2 调换 一 下 ,让 顺序 变 为 1 、 
2,3,4。 


// 先 找 出 元 素 3 

var foundnode = list2.Find(3); 

// 获取 元 素 2 的 结 点 

var thirdnode = foundnode. Next; 

// 将 该 元 素 移 除 

list2. Remove( foundnode); 

// 再 把 这 个 元 素 插入 到 2 之 后 

list2. AddAfter(thirdnode, foundnode. Value); 


调整 方法 是 : 先 找 出 3 所 在 的 结 点 ,再 通过 这 个 结 点 找 
到 2 所 在 的 结 点 (因为 两 个 结 点 是 连续 的 ,所 以 可 以 通过 
Next 属性 获取 )。 接 着 将 3 移 除 ,最 后 再 插入 到 2 的 后 面 。 


图 6-20 ”两 个 LinkedList 


步骤 7: 运行 应 用 程序 ,控制 台 输 出 的 结果 如 图 6-20 集合 中 的 元 素 
所 示 。 

实例 186 自 定义 相等 比较 

【导语 】 


要 判断 两 个 对 象 是 否 相等 ,框架 默认 的 比较 方式 有 时 并 不 能 满足 实际 开发 需求 ,尤其 是 
在 使 用 字典 等 数据 结构 的 场合 。 这 时 候 , 开 发 人 员 应 当 考虑 实现 所 需要 的 相等 比较 方式 。 

编写 自 定 义 的 相等 比较 逻辑 ,有 以 下 几 个 可 选 方案 。 

(1) 重 写 Object 类 的 Equals 方法 。 由 于 Equals 是 在 Object 类 中 定义 的 虚 方 法 ,并 且 
所 有 类 型 都 以 Object 为 基 类 ,因此 在 自 定义 的 类 型 中 ,可 以 通过 重 写 Equals 方法 来 安排 比 
较 逻 辑 。 

(2) 实现 IEqualityComparer 接口 。 该 接口 除了 有 Equals 方法 外 ,还 需要 实现 
GetHashCode 方法 。GetHashCode 方法 返回 一 个 int 值 , 用 于 唯一 标识 该 对 象 , 即 为 对 象 设 
置 一 个 索引 。 返 回 哈 希 码 可 以 提升 两 个 对 象 在 相等 比较 中 的 处 理 效率 ,如 果 两 个 对 象 返 回 
相同 的 哈 希 码 ,就 可 以 认为 两 者 是 相等 的 ,这 样 就 省 去 了 深度 比较 所 花费 的 性 能 开销 。 当 哈 
希 人 码 无 法 为 对 象 进行 唯一 标识 时 ,就 会 调用 Equals 方法 进行 更 深层 次 的 比较 。 

(3) 实现 IEqualityComparer < 本 > 接 口 。IEqualityComparer 接口 是 针对 object 类 型 
的 ,对 类 型 的 约束 不 强 , 而 且 比 较 过 程 中 会 进行 大 量 的 类 型 转换 (频繁 装 箱 与 拆 箱 ) ,造成 一 
定 的 性 能 损失 。IEqualityComparer< 工 > 属于 泛 型 接口 ,可 通过 类 型 参数 T 对 比较 对 象 的 
类 型 进行 约束 ,提升 比较 运算 的 效率 。 
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(4) 实现 EqualityComparer < 工 > 抽 象 类 。 此 类 实现 了 IEqualityComparer 与 
IEqualityComparer < 了 > 两 个 接口 (对 IEqualityComparer 接口 采取 了 显 式 实现 方案 ) ,并且 
包括 框架 的 默认 比较 方案 (通过 基态 的 Default 属性 可 以 获取 ) 。 

在 现实 开发 过 程 中 ,笔者 比较 推荐 实现 EqualityComparer < 本 > 抽象 类 的 方案 ,因为 此 
方案 既 有 框架 内 部 的 默认 实现 ,又 包含 自 定义 的 实现 ,可 用 性 更 强 。 

本 实例 将 演示 如 何 实现 EqualityComparer< 工 > 抽象 类 ,并 通过 HashSet < T > 集合 进 
行 测试 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 一 个 Contact 类 ,模拟 联系 人 信息 (包括 身份 标识 、 姓 名 、 手 机 号 三 个 属性 )。 


public class Contact 

{ 
public string Name { get; set; } 
public string PhoneNo { get; set; } 
public long ID { get; set; } 

} 


步骤 3: 实现 EqualityComparer < 本 > 抽象 类 ,实现 两 个 Contact 对 象 的 相等 比较 ,T 参 
数 的 类 型 为 Contact。 


Eublic sealed class ContactEqualityComparer : EqualityComparer < Contact> 
{ 
public override bool Equals(Contact x, Contact y) 
{ 
if (x == null || Y == null) 
return false; 
if (object. ReferenceEquals(x, y)) 
return true; 
if (x.ID == Y.ID && x.Name == Y.Name && x.PhoneNo == y.PhoneNo) 
return true; 


return false; 


public override int GetHashCode(Contact obj) 
return obj. ID. GetHashCode( ) ^ obj. Name. GetHashCode( ) ^ obj. PhoneNo. GetHashCode( ); 


} 


GetHashCode 方法 的 最 优 实现 方案 是 : 既 能 得 到 对 象 的 唯一 标识 ,又 能 尽 可 能 地 简单 
以 保证 运算 效率 。 一 般 来 说 ,将 类 型 中 各 个 属性 (或 字段 ) 的 值 的 哈 希 码 进行 “ 异 或 ?运算 ,这 
种 运算 法 则 被 称 为 “ 同 为 0, 异 为 1”。 
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在 实现 Equals 方法 时 ,进行 了 以 下 三 个 层次 的 比较 : 四 如 果 两 个 Contact 对 象 中 有 其 
中 一 个 为 null, 则 无 须 再 深入 分 析 , 二 者 必然 不 相等 ; @ 引 用 比较 ,如 果 两 者 指向 的 是 同一 
个 对 象 实例 ,必然 是 相等 的 ; @@ 如 果 以 上 两 个 层次 均 无 法 判定 ,就 对 Contact 对 象 的 三 个 属 
性 值 进行 一 一 比较 。 

步骤 4: 由 于 HashSet < 人 下 > 集合 中 不 存放 重复 的 元 素 ,因此 使 用 该 集合 进行 相等 比较 
测试 的 效果 明显 。 实 例 化 一 个 HashSet 集合 ,并 将 刚才 定义 的 ContactEqualityComparer 
实例 传递 给 构造 函数 ,这 样 就 可 以 覆盖 HashSet 集合 中 元 素 的 默认 比较 方案 。 


HashSet < Contact > set = new HashSet < Contact>(new ContactEaualityComparer()); 
步骤 5: 在 集合 中 执行 五 次 添加 元 素 操作 。 详 见 代 码 清单 6-6。 
代码 清单 6-6 ”执行 五 次 添加 元 素 操 作 


set. hdd(new Contact 
{ 
ID = 721001, 
Name = " 老 李 "， 
PhoneNo = "223225688" 
); // 第 一 次 添加 


// 添加 相同 实例 
Contact cl = new Contact 
{ 
ID = 7412002, 
Name = " 老 何 "， 
PhoneNo = "1685584562" 
}; 
Contact c2 = cl; 
set. Add(c1); // 第 二 次 添加 
set. add(c2); // 第 三 次 添加 


// 不 同 实例 ,但 属性 值 相同 
Contact c3 = new Contact 
{ 
ID = 500002, 
Name = " 老 肖 "， 
PhoneNo = "170023" 
EB 
Contact c4 = new Contact 
{ 
ID = 500002, 
Name = " 老 肖 "， 
PhoneNo = "170023" 
1 
set. Add(c3); // 第 四 次 添加 
set. Add(c4); // 第 五 次 添加 
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步骤 6: 输出 集合 中 所 有 元 素 。 


foreach (Contact c in set) 
{ 
string msg = $ "身份 标识 :{c. ID}\n" + 
$ "姓名 :{c.Name}\n" + 
$ "手机 :{c.PhoneNo}\n"; 
Console. WriteLine(msg); 
} 
虽然 添加 了 五 次 元 素 ,但 集合 中 仅 有 3 个 元 素 , 原 因 是 : 第 
次 添加 的 是 一 个 全 新 的 Contact 对 象 ,这 是 一 个 元 素 ; 第 二 次 
和 第 三 次 添加 的 元 素 都 引用 了 同一 个 对 象 实例 ,只 能 算 一 个 元 
素 ; 第 四 次 和 第 五 次 添加 的 元 素 虽 然 不 是 同一 个 实例 ,但 它们 的 
各 自 对 应 的 属性 值 相同 , 视 为 相等 ,也 只 能 算 一 个 元 素 , 总 共 为 3 


个 元 素 。 出 
图 6-21 仅 输出 3 个 元 素 
步骤 7: 运行 应 用 程序 ,输出 结果 如 图 6-21 所 示 。 


实例 187 请 空 集合 中 的 所 有 元 素 


【导语 】 

许多 集合 都 公开 了 Clear 方法 ,可 以 一 次 性 删除 集合 中 的 所 有 元 素 。Remove 方法 通常 
只 能 删除 一 个 元 素 , 虽 然 可 以 通过 循环 语句 调用 Remove 方法 来 删除 集合 中 的 所 有 元 素 ,但 
也 不 如 一 次 性 调用 Clear 方法 简练 ,余下 的 删除 操作 就 在 运行 时 由 框架 处 理 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


using System. Collections. Generic; 
步骤 3: 创建 List< 工 > 实例 ,并 添加 一 些 元 素 。 
List< int> list = new List< int >(); 

list. Add(25); 


list. Add(26); 
list. Add(27); 


步骤 4: 在 调用 Clear 方法 前 后 ,分 别 输出 列表 中 元 素 的 个 数 ,以 便 观 察 


Console. WriteLine( "列表 中 元 素 个 数 :{0}"， list. Count); 
list.Clear(); 
Console. WriteLine(" 调 用 Clear 方法 后 ,列表 中 的 元 素 个 数 :{0}"，list. Count); 
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步骤 5: 按 F5 快捷 键 运行 应 用 程序 ,控制 台 输 出 内 容 如 下 。 


列表 中 元 素 个 数 :3 
调用 Clear 方法 后 ,列表 中 的 元 素 个 数 :0 


实例 188 ”判断 字典 集合 中 是 否 存 在 某 个 键 


【导语 】 
字典 中 每 个 项 都 由 键 (Key) 和 值 (Value) 组 成 ,其 


Ph, 键 是 用 来 对 该 项 进行 唯一 性 标识 


的 , 即 键 在 整个 字典 集合 中 是 无 重复 的 ,但 值 是 可 以 重复 的 。 
向 字典 集合 中 写 人 项 时 ,一般 的 情况 是 : 如 果 某 个 键 不 存在 , 便 新 增 一 条 键 / 值 对 , 即 添 


加 新 项 ; 如 果 某 个 键 已 经 存在 , 则 将 与 该 键 对 应 的 值 蔡 
免 访问 不 存在 的 键 ,在 读 取 之 前 应 该 先 检测 一 下 键 的 存 


换 掉 。 从 字典 集合 中 读 取 时 ,为 了 如 
在 性 。 


字典 集合 类 型 (如 Hashtable、 Dictionary 等 ) 会 公开 一 个 ContainsKey 方法 ,通过 该 方 


法 可 以 得 到 一 个 布尔 值 ,以 指示 要 查找 的 键 是 否 存在 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 


步骤 2: 引入 以 下 命名 空间 ,以 便 访问 Dictionary 类。 


using System. Collections. Generic; 


步骤 3: 创建 一 个 字典 实例 ,其 中 Key 的 类 型 为 string ,Value 的 类 型 为 double。 


IDictionary < string, double> dic = new Dictionary< string, double>(); 


步骤 4: 向 字典 中 添加 元 素 。 


dic["a"] 0.0001d; 
dic["b"] 0.0002d; 
dic["c"] = 0.0003d; 


步骤 5: 分 别 检测 键 %a” 与 键 “b” 是 否 存在 于 字典 集合 中 。 


Console. WriteLine(" 键 "a"{0}", dic.ContainsKey("a") ? 
Console. WriteLine(" 键 "d"{0}", dic.ContainsKey("d") ? 


步骤 6: 运行 应 用 程序 ,控制 台 输 出 结果 如 下 。 
键 "a" 存 在 

键 "d" 不 存在 

实例 189 定义 索引 器 


【导语 】 
索引 器 跟 属 性 比较 相似 ,同样 具有 get 和 set 访 癌 


"存在 " : "不 存在 "); 
"存在 " : "不 存在 "); 


1 器。 不 同 的 是 ,索引 器 带 有 一 个 参 


qt 
小 
册 


泛 型 与 集合 | 因 227 


数 即 索 引 。 例 如 ,可 以 用 以 下 旬 式 访问 数组 中 某 个 元 素 。 
a = arr[2]; 


这 是 一 个 典型 的 索引 器 ,其 中 2 是 传递 给 索引 器 的 参数 。 
索引 器 的 声明 格式 如 下 。 


< 修饰 符 > < 类 型 > this[< 参 数列 表 >] 
{ 


get {-* } 
set { … } 
} 
this 是 索引 器 的 固定 名 称 , 表 示 通 过 对 象 实例 进行 访问 。 中 括号 内 可 以 包含 多 个 参数 ， 
但 是 大 多 数 情况 下 只 定义 一 个 参数 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 类 ,里 面包 装 了 一 个 byte 数组 ,外 部 代码 可 以 通过 类 公开 的 索引 器 与 
byte 数组 交互 。PrintAll 方法 用 于 向 控制 台 输 出 byte 数组 中 的 所 有 元 素 。 详 见 代码 清单 6-7。 


代码 清单 6-7 带 索 引 器 的 示例 类 


public class MySample 


{ 
private byte[ ] _data = new byte[10]; 


public byte this[ int index] 


get 
{ 
if (index <0 || index >= _data. Length) 
return 0; 
return data[ index]; 


if (index >= 0 || index < _data. Length) 
{ 
_data[ index] = value; 


} 
} 


public void PrintAll() 

{ 
string msg = string.Join(",\", _data); 
Console. WriteLine( $ "元 素 列表 :\n{msg}\n\n"); 
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步骤 3: 创建 MySample 类 的 新 实例 。 
MySanple sa = new MySanplel); 


步骤 4: 通过 索引 器 ,向 实例 内 部 byte 数组 的 元 素 赋值 。 


sa[0] = 209; 
sa[1] = 39; 
sa[5] = 122; 
sa[9] = 60; 


步骤 5: 调用 一 次 PrintAll 方法 ,输出 对 象 内 部 byte 数组 中 所 有 元 素 。 
sa. PrintAll(); 


步骤 6: 运行 应 用 程序 ,输出 结果 如 图 6-22 所 示 。 


CNprogram Files\dotnet\.. — 口 x 


6-22 输出 byte 数组 中 的 元 素 


实例 190” 带 多 个 参数 的 索引 器 


【导语 】 
索引 器 支持 多 个 参数 ,但 至 少 要 包含 一 个 参数 , 它 与 方法 不 同 ,方法 可 以 不 带 参数 。 本 
实例 将 演示 一 个 带 两 个 参数 的 索引 器 (只 读 , 仅 包含 get 访问 器 ) ,并 返回 两 个 参数 的 乘积 。 
【操作 流程 】 
步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 ， 
步骤 2: 声明 一 个 类 ,其 中 包含 一 个 索引 器 。 该 索引 器 有 两 个 int 类 型 的 参数 ,并 返回 
这 两 个 参数 的 乘积 。 
public class Test 
{ 
public long this[ int a, int b] 
{ 
get 
{ 


returna * b; 
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步骤 3: 实例 化 Test 对 象 。 

Test t = new Test(); 

步骤 4: 通过 索引 器 计算 两 个 整数 值 的 乘积 。 
longr = t[800, 20000]; 

步骤 5: 输出 计算 结果 。 

Console. WriteLine( $ "计算 结果 : {r}"); 

步骤 6: 运行 应 用 程序 ,控制 台 输 出 内 容 如 下 。 


计算 结果 : 16000000 


实例 191 使 用 泛 型 的 栈 队列 


【导语 】 

“ 栈 ? 是 一 种 数据 结构 , 它 的 特点 是 “后 进 先 出 ”。 它 犹如 一 个 单 向 开口 的 箱子 , 先 放 进 去 
的 东西 位 于 箱子 底部 ,后 放 进去 的 东西 会 往 上 堆 琶 。 当 要 从 箱子 中 取出 东西 时 ,要 先 拿 掉 上 
面 的 东西 ,最 后 才能 取出 箱子 底部 的 东西 。 

Stack < 全 > 是 栈 结构 的 泛 型 版 本 , 相 比 于 面向 object 类 型 的 版 本 ,使 用 泛 型 版 本 的 集合 
可 以 避免 频繁 的 类 型 转换 而 导致 的 性 能 损耗 。 

向 栈 队列 中 添加 元 素 叫 人 栈 :也 叫 压 栈 。 此 时 需要 调用 Push 方法 完成 人 栈 操作 。 相 
反 地 ,从 栈 队列 中 取出 元 素 称 为 出 栈 , 或 叫 弹 栈 。 出 栈 需 要 调用 Pop 方法 ,该 方法 返回 取出 
的 元 素 ,并 从 栈 队 列 中 删除 该 元 素 。 也 就 是 说 每 出 栈 一 个 元 素 , Count 属性 就 会 碱 1。 此 
外 ,还 有 一 个 Peek 方法 ,此 方法 也 能 取出 栈 队 列 中 的 元 素 , 但 不 会 删除 该 元 素 。 若 希望 在 出 
栈 操作 时 避免 错误 ,还 可 以 调用 TryPop 或 TryPeek 方法 。 这 两 个 方法 如 果 操作 失败 ,会 返 
回 false; 而 不 会 抛 出 异常 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 实例 化 一 个 Stack <T> 对 象 , 类 型 参数 T 为 int 类 型 。 


Stack< int > st = new Stack< int >(); 
步骤 3: 调用 Push 方法 ,向 栈 队 列 中 压 人 三 个 元 素 。 


st. Push(3); 
st. Push(2); 
st. Push(1); 


步骤 4: 弹 栈 方法 一 ,调用 Pop 方法 让 元 素 出 栈 , 并 随时 检查 Count 属性 是 否 为 0。 


while (st.Count > 0) 
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{ 
Console. WriteLine( st. Pop()); 
} 


步骤 5: 弹 栈 方法 二 ,调用 TryPop 方法 弹出 元 素 . 直 到 其 返回 false( 栈 队列 中 已 无 元 素 )。 


while (st. TryPop(out int x)) 
{ 
Console. WriteLine(x); 
} 
由 于 栈 队 列 遵 循 的 是 “后 进 先 出 ”顺序 ,上 面 代 码 中 , 放 入 栈 队 列 中 的 顺序 是 3、2、1, 而 
取出 来 的 顺序 应 当 为 1.2、3。 


实例 192 ”自动 排序 的 字典 集合 


【导语 】 

SortedDictionary < TKey, TValue > 与 常规 字典 集合 相 比 ,多 了 一 个 特殊 功能 一 一 自动 
排序 。 向 字典 中 添加 键 / 值 对 时 ,会 自动 将 集合 中 所 有 项 按照 键 (Key) 进 行 排序 。 

本 实例 将 演示 默认 排序 方案 , 即 按照 升序 排序 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 创建 SortedDictionary <TKey, TValue > 实例 ,其 中 TKey 为 int 类 型 ,TValue 
为 string 类 型 。 


SortedDictionary< int, string> dic = new SortedDictionary< int, string>(); 


步骤 3: 向 字典 中 添加 项 目 。 


dic[20] = "hook"; 
dic[5] = "book"; 
dic[32] = "look"; 
dic[3] = "disk"; 
dic[12] = “ligt”y 
dic[7] = "foot"; 


上 述 代码 中 ,为 每 个 项 设 定 的 Key 是 不 规律 的 ,添加 到 字典 集合 
后 ,会 自动 完成 排序 。 
步骤 4: 输出 字典 集合 中 每 个 项 的 Key 和 Value。 
foreach (var p in dic) 
{ 
Console. Write("{0} — {1}\n", p.Key, p. Value); 
} 图 6-23 完成 排序 后 


步骤 5: 运行 应 用 程序 ,会 看 到 如 图 6-23 所 示 的 输出 结果 。 的 键 / 值 对 
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实例 193” 自 定义 SortedDictionary 集合 的 排序 规则 


【导语 】 
SortedDictionary 类 的 构造 函数 中 有 以 下 重 载 : 


public SortedDictionary(IComparer < TKey > comparer); 


这 个 版 本 的 构造 函数 为 自 定义 排序 规则 提供 了 可 能 。 本 实例 将 演示 从 Comparer < 了 > 类 派 
生出 一 个 自 定义 的 比较 器 ,对 字符 串 的 长 度 进行 比较 。 最 终 实 现 效 果 是 让 SortedDictionary 
字典 的 Key 按照 字符 串 的 长 度 进行 升序 排序 , 即 字 符 串 长 度 越 长 ,次序 就 越 靠 后 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


using System. Collections. Generic; 
步骤 3: 自 定 义 比 较 器 ,比较 两 个 字符 串 对 象 的 长 度 。 


public class CustSortConparer : Comparer < string> 


{ 


public override int Compare( string x, string y) 


E 
return x. Length — y.Length; 


’ 
$ 
比较 代码 很 简单 ,将 两 个 字符 串 对 象 的 长 度 相 减 即 可 。 如 果 两 者 长 度 相 等 ,就 返回 0; 
如 果 x 的 长 度 大 于 y 的 长 度 , 就 返回 正 值 ; 如 果 x 的 长 度 小 于 y 的 长 度 , 就 返回 负 值 ,在 字 
典 集合 中 ,就 能 使 各 项 的 Key 按 字符 串 长 度 进行 升序 排列 了 。 
步骤 4: 在 Main 方法 中 创建 SortedDictionary 实例 ,并 向 构造 函数 传递 上 面 定 义 的 
CustSortComparer 对 象 。 


SortedDictionary < string, DateTime > dic = new SortedDictionary < string, DateTime > ( new 
CustSortComparer() ); 


步骤 5: 向 字典 中 添加 项 ,注意 各 项 的 键 长 度 。 


dic["ab"] = new DateTine(2018，1，1) 7 
dic["hijklmn" ] = new DateTime(2018, 1, 3); 
dic["opqr"] = new DateTime(2018, 1, 5); 
dic["s"] = new DateTime(2018, 1, 7); 
dic["stuvwxyz"] = new DateTime(2018, 1, 9); 


步骤 6: 尝试 将 字典 中 的 各 项 输出 。 


foreach (var dp in dic) 


ED Ea 


实 卫 194 “ 完 庄 汗 出 台 玉 
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A 
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当 队 列 中 的 元 素 被 取 完 后 ,TryDequeue 方法 会 返回 false, 所 以 可 以 用 一 个 while 循环 
来 取出 所 有 元 素 。 元 素 进去 时 的 顺序 为 3、2、1, 根 据 先 进 先 出 ”的 规律 ,最 后 输出 的 顺序 也 
是 3521 


实例 195” 自 定义 ToReadOnlyDictionary 方法 


【导语 】 

在 某 些 特定 的 应 用 场景 中 ,程序 创建 宇 典 集合 的 实例 后 ,并 不 希望 宇 典 中 的 数据 被 修 
改 , 即 只 读 宇 典 。 在 .NET 类 库 中 ,有 一 个 名 为 ReadOnlyDictionary 的 泛 型 类 ,该 类 可 以 通 
过 现 有 的 字典 集合 创建 一 个 只 读 的 字典 集合 。 

下 面 代码 演示 如 何 创建 只 读 的 字典 集合 。 


IDictionary < int, string> srcdic = new Dictionary< int, string>(); 


srcdic[1] = "a"; 
sredic[2] = "b"; 
srcdic[3] = "ec"; 


ReadonlyDictionary < int, string> rodic = new ReadOnlyDictionary < int, string>(srcdic); 


而 本 实例 则 是 通过 对 IDictionary < TKey,， TValue > 接口 进行 扩展 ,使 生成 只 读 字 典 的 
功能 更 具 通用 性 和 灵活 性 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 一 个 DictionaryExtensions 类 ,在 类 中 定义 扩展 方法 ,对 IDictionary 接口 
进行 扩展 ,返回 一 个 只 读 宇 典 集合 。 


public static class DictionaryExtensions 


public static IReadOnlyDictionary < TKey, TValue > ToReadOnlyDictionary < TKey, TValue > 
(this IDictionary < TKey, TValue> srcDictionary) 


{ 


return new ReadOnlyDictionary < TKey, TValue >(srcDictionary); 


} 


注意 : 包含 扩展 方法 的 类 要 声明 为 静态 类 ,扩展 方法 也 要 声明 为 静态 的 。 


步骤 3: 在 Program 类 中 定义 一 个 方法 ,用 于 返回 一 个 只 读 字典 集合 实例 ,在 方法 的 实 
现代 码 中 ,调用 上 面 定 义 的 扩展 方法 。 


static IReadOnlyDictionary < string, string> GetReadOnly() 
{ 


IDictionary< string, string>d = new Dictionary< string, string>(); 
d["city"] = "Guang Zhou"; 
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df "name"] = "Mr Liu"; 
d["subject"] = "RSP.NET Core"; 
return d. ToReadOnlyDictionary(); 
} 


在 产生 只 读 字 典 前 ,要 先 初 始 化 可 读 可 写 的 字典 集合 ,否则 无 法 存 人 数据 。 
步骤 4: 在 Main 方法 中 ,尝试 调用 GetReadOnly 方法 。 


IReadOnlyDictionary < string, string> rdic = GetReadOnly(); 


步骤 5: 输出 只 读 字典 中 各 项 的 Key 和 Value。 


foreach(string key in rdic. Keys) 


t 


Console. WriteLine("{0} — {1}", key, rdic[key]); 
} 


步骤 6: 运行 应 用 程序 ,控制 台 输 出 结果 如 图 6-25 所 示 。 
实例 196 ”初始 化 字典 集合 的 方法 


【导语 】 
有 三 种 初始 化 字典 集合 的 方法 。 
(1) 调用 Add 方法 。 


图 6-25 只 读 字典 中 的 数据 


Dictionary < int, double> dict = new Dictionary< int, double >(); 
dict. Add(200, 0.000021d); 


Add 方法 的 第 一 个 参数 是 新 元 素 的 Key, 第 二 个 参数 是 新 元 素 的 Value。 如 果 Key 已 经 存 
在 ,会 替换 Value。 
(2) 通过 索引 器 赋值 。 


IDictionary < float, float > dicx = new Dictionary< float, float >(); 
dicx[0.1f] = 0.00001f; 
dicx[0.2f] = 0.00002f; 


(3) 在 调用 构造 函数 后 立即 填充 元 素 。 


Dictionary < string, int> d2 = new Dictionary< string, int> 


["a"] = 100, 
["b"] = 200, 
["c"] = 300 
}; 
【操作 流程 】 


步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
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步骤 2: 创建 第 一 个 字典 对 象 , 使 用 索引 器 来 初始 化 。 


Dictionary < string, string> dicl = new Dictionary< string, string>(); 
dici["k1"] = "val_1"; 
dicl["k2"] = "val_2"; 
dicl["k3"] = "val 3"; 


步骤 3: 创建 第 二 个 字典 对 象 ,调用 Add 方法 初始 化 。 


Dictionary< int, long> dic2 = new Dictionary< int, long>(); 
dic2. Add(1, 1560000); 
dic2. Add(2, 1570000); 
dic2. Add(3, 1580000); 


步骤 4: 创建 第 三 个 字典 对 象 ,在 调用 构造 函数 之 后 马上 初始 化 。 


Dictionary <decimal, DateTime > dic3 = new Dictionary< decimal, DateTime> 


{ 
[12M] = new DateTime(2017, 9, 1), 
[13M] = new DateTime(2017, 10, 1), 
[14M] = new DateTime(2017, 11, 1) 
}; 


实例 197 ”ArrayList 的 使 用 


【导语 】 

ArrayList 类 与 List< 工 > 有 些 类 似 ,支持 在 集合 中 添加 和 删除 元 素 ,但 是 ArrayList 是 
面向 object 类 型 的 , 读 写 元 素 的 过 程 中 会 发 生 大 量 的 类 型 转换 ,从 而 增加 性 能 开销 。 因 此 ， 
比较 庞大 的 集合 应 当 优先 考虑 使 用 泛 型 集合 ,而 小 型 集合 使 用 ArrayList 类 所 带 来 的 性 能 
开销 较 小 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 实例 化 一 个 ArrayList 集合 。 


ArrayList list = new RrrayList() 


步骤 3: 添加 三 个 元 素 。 


list. Add(5580); 
list.Add(7899878L); 
list.Add('v'); 


步骤 4: 删除 集合 中 的 第 一 个 元 素 。 
list. RemoveAt(0); 


RemoveAt 方 法 可 以 把 指定 索引 处 的 元 素 移 除 。 
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步骤 5: 再 添加 两 个 元 素 。 


list. Add( "test"); 

list.Add( (uint)36000); 

由 于 常量 表达 式 36000 默认 被 识别 为 int 类 型 ,而 此 处 希望 添加 的 数据 类 型 是 uint, 因 
此 要 显 式 地 进行 类 型 转换 。 

步骤 6: 输出 集合 中 的 元 素 , 以 便 观 察 。 


foreach(object o in list) 


本 


Console.WriteLine(o) 


} 
步骤 7: 此 时 ,集合 中 应 有 4 个 元 素 ,输出 的 内 容 如 下 。 


7899878 

ee 

36000 

实例 198 ”使 用 Span < 了 > 提升 处 理 字符 串 的 性 能 
【导语 】 


.NET 中 许多 类 型 都 是 在 托管 堆 中 分 配 内 存 的 ,在 对 连续 内 存 块 进行 操作 时 , 某 些 数据 
类 型 会 比较 花 时 间 , 其 中 最 典型 的 是 字符 串 。 在 处 理 字符 串 的 过 程 中 会 不 断 创建 新 的 实例 ， 
这 些 过 程 必 将 占用 一 定 的 时 间 。 

.NET Core 类 库 提 供 了 一 种 特殊 的 结构 一 -Span<T>, 它 可 以 用 于 操作 各 种 连续 分 
布 的 内 存 数 据 。 可 以 通过 以 下 来 源 初 始 化 Span < >。 

(1) 常见 的 托管 数组 。 

(2) 栈 内 存 中 的 对 象 。 

(3) 本 地 内 存 指针 。 

此 外 ,Span< 工 > 支持 GC 功能 ,不 需要 显 式 释 放 内 存 。 与 Span< 工 > 对 应 ,还 有 一 个 只 
读 版 本 一 一 ReadOnlySpan< 了 T>。 

本 实例 演示 了 用 两 种 方法 将 某 个 字符 串 中 的 两 个 字符 (“2” 和 “0”) 转 换 为 int 数值 20， 
并 且 使 用 Stopwatch 组 件 分 别 计算 两 种 方法 所 消耗 的 时 间 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 并 初始 化 一 个 字符 串 实 例 , 稍 后 做 测试 使 用 。 


string str = "我 家 里 养 了 20 只 猫 "; 
步骤 3: 第 一 种 处 理 方法 ,调用 Substring 方法 取出 “2” 和 “0” 两 个 字符 ,再 通过 Parse 方 
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nq 


法 产生 int 实例 。 


Stopwatch swl = Stopwatch. StartNew(); 
for(int x = 0; x < 10000000; x++) 
{ 
int v = int.Parse(str.Substring(5, 2)); 
} 
swl. Stop(); 
Console. WriteLine( $ "常规 方法 : 耗 时 {swl. ElapsedMilliseconds} ms"); 


步骤 4: 第 二 种 方法 ,使 用 Span <T>,T 为 char 类 型 。 调 用 Slice 方 法 取出 *2” 和 “0” 两 
个 字符 ,再 通过 自 定义 代码 将 其 转换 为 int 值 。 


Stopwatch sw2 = Stopwatch. StartNew(); 
ReadonlySpan < char > span = str.ToCharArray(); 
for (int x = 0; x<10000000; xt+) 
{ 
intv = 0; 
var subspan = span.Slice(5, 2); 
for(int i = 0; i< subspan.Length; i++) 
{ 
char ch = subspan[i]; 
v= (ch— '0') +v* 10; 


sw2. Stop( ); 
Console. WriteLine( $ "使 用 Span: 耗 时 {sw2. ElapsedMilliseconds} ms"); 


由 于 从 Span 实例 中 取出 来 的 元 素 是 char 类 型 ,为 了 能 得 
到 与 字符 相对 应 的 整数 值 ,应 该 将 其 减 去 字符 “0” 的 ASCII 码 。 
字符 “0” 的 ASCII 码 是 48, 以 此 类 推 ,字符 “1” 的 ASCII 码 为 
49, 字 符 “2” 的 ASCII 码 为 50 ,如果 要 使 字符 “2” 与 整数 2 对 应 ， 
就 要 用 50 减 去 48。 图 6-26 两 种 处 理 方法 

步骤 5, 运行 应 用 程序 ,如 图 6-26 所 示 ,通过 对 比 代码 执行 有 
时 间 ,采用 Span<T> 的 效率 较 高 。 


CPro — 口 x 


注意 : 为 了 能 让 对 比 的 效果 更 直观 ,本 实例 在 一 个 for 循环 中 将 每 种 处 理 方法 的 代码 重复 执 
行 了 10000000 次 。 
在 计时 的 时 候 ,Stopwatch 组 件 自身 也 会 消耗 一 定 的 CPU 资源 ,因此 代码 执行 所 耗 
费 的 准确 时 间 与 Stopwatch 所 计算 的 结果 会 存在 误差 , 仅 用 于 参考 。 
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实例 199 ”多 个 Task 同时 操作 ConcurrentBag 集合 


【导语 】 

ConcurrentBag < 本 > 是 一 个 泛 集合 , 它 较 为 明显 的 优点 是 可 以 在 多 个 线程 上 同时 访问 ， 
并 且 该 集合 是 无 序 的 , 即 从 集合 中 取出 元 素 的 顺序 可 能 与 放 入 的 顺序 不 一 致 。 

要 向 集合 中 添加 元 素 可 以 调用 Add 方法 。 而 取出 元 素 则 有 两 个 方法 可 用 : TryTake 
方法 取出 元 素 然后 把 元 素 从 集合 中 删除 ,TryPeek 方法 取出 元 素 但 不 会 删除 元 素 。 

要 判断 ConcurrentBag < > 集合 中 是 否 存在 元 素 , 一 种 方法 是 访问 Count 属性 , 它 表 
示 和 集合 中 包含 元 素 的 个 数 ; 另 一 种 方法 是 访问 IsEmpty 属性 ,如 果 集 合 为 空 则 返回 true。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 实例 化 ConcurrentBag < 工 > 集 合 ,参数 工 为 int 类 型 。 


ConcurrentBag < int > bag = new ConcurrentBag < int >(); 


步骤 3: 在 项 日 生成 的 Program. cs 文件 头 部 的 using 指令 块 中 ,添加 对 以 下 命名 空间 
的 引用 。 


using System. Collections. Concurrent; 
using System. Threading. Tasks; 


步骤 4: 启动 第 一 个 Task ,向 集合 中 添加 元 素 。 


Task tl = Task.Run(() => 
i 
for (intk = 45; k < 51; k++) 
t 
Console. WriteLine(" 即 将 添加 元 素 :{0}"，k); 
bag Add(k); 


D; 


步骤 5: 启动 第 二 个 Task, 从 集合 中 取出 元 素 , 此 Task 在 第 一 个 Task 执行 之 后 执行 。 


Task t2 = t1.ContinueWith((task) => 
{ 
while (1bag. IsEmpty) 
{ 
if(bag. TryTake(out int item)) 
{ 
Console. WriteLine(" 已 取出 元 素 :{0}",， item); 
} 
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ContinueWith 方法 指定 在 某 个 Task 之 后 延续 新 的 Task。 如 果 国 | 
两 个 Task 同时 执行 , 由 于 集合 的 初始 状态 是 空 的 ,会 导致 第 二 个 
Task 中 无 法 获取 到 元 素 。 所 以 要 让 第 一 个 Task 先 执行 ,这 样 在 执行 
第 二 个 Task 时 ,就 能 保证 集合 中 是 有 元 素 的 。 

步骤 6: 调用 WaitAll 方法 ,让 当前 线程 暂停 执行 ,等 待 上 面 两 个 
Task 执行 完成 再 继续 。 


Task. WaitAll(t1, t2); 


步骤 7: 运行 应 用 程序 ,控制 台 输 出 信息 如 图 6-27 所 示 。 
实例 200” 跨 线程 访问 BlockingCollection 集合 


【导语 】 

BlockingCollection < T > 集合 允许 多 线程 访问 (添加 或 移 除 元 素 ) 。 当 集合 中 的 元 素数 
量 达到 容量 上 限时 ,添加 操作 会 被 阻止 ,直到 集合 中 有 元 素 被 移 除 ( 重 新 获得 可 用 容量 ); 同 
样 地 , 当 从 集合 中 移 除 元 素 时 ,如 果 集 合 中 无 可 用 元 素 ,那么 移 除 操作 会 被 阻止 ,直到 集合 中 
有 新 的 元 素 加 入 。 

多 个 线程 可 以 同时 调用 Add 或 TryAdd 方法 向 集合 添加 元 素 , 也 可 以 同时 调用 Take 
或 TryTake 方 法 移 除 元 素 。 当 调用 CompleteAdding 方法 后 ,就 不 能 再 向 集合 中 添加 元 素 
了 ,否则 会 引发 异常 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 创建 BlockingCollection<T > 实例 ,T 为 int 类 型 。 


6-27 ” 跨 线 程 添加 
和 读 取 元 素 


using (BlockingCollection < int> bc = new BlockingCollection< int>()) 
{ 


} 


BlockingCollection < 开 > 类 实现 了 IDisposable 接口 , 若 不 再 使 用 要 将 其 释放 。 将 初始 
化 代码 放 在 using 语句 块 中 ,当代 码 离开 using 块 时 会 自动 调用 Dispose 方 法 。 
步骤 3: 在 using 代码 块 内 部 ,创建 第 一 个 Task, 用 于 向 集合 添加 元 素 。 


Task tl = Task.Run(async () => 
{ 
for (int k = 0; k<5; k++) 
{ 
int iten = k + 1; 
Console. WriteLine(" 即 将 添加 元 素 :{0}"，item); 
bc. Rdd(item) ; 
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await Task. Delay(650); 
} 
// 标记 添加 操作 已 完成 
bc. CompleteAdding( ); 
D; 


在 调用 CompleteAdding 方法 后 ,集合 被 标记 为 已 完成 添加 操作 ,此 时 所 有 线程 均 无 法 
再 向 集合 添加 元 素 。 
步骤 4: 创建 第 二 个 Task ,用 于 从 集合 中 移 除 元 素 。 


Task t2 = Task.Run(() => 
{ 
while (true) 
{ 
if (bc. TryTake(out int item) ) 
{ 
Console. WriteLine(" 取 出 元 素 :{0}"，item); 


} 
// 是 否 退 出 循环 
if (bc. IsSCompleted) break; 
} 
DD); 
当 集 合 中 的 所 有 元 素 都 被 移 除 了 ( 空 集合 ),IsCompleted 属性 
会 变 为 true, 此 时 就 可 以 退出 while 循环 了 。 
步骤 5: 调用 WaitAll 方 法 等 待 所 有 Task 执行 完成 ,然后 释 
放 上 述 两 个 Task。 


Task. WaitAll(t1, t2); 
t1. Dispose(); 
t2. Dispose(); 


步骤 6: 运行 应 用 程序 ,输出 结果 如 图 6-28 所 示 。 图 628 ”路 然 程 添加 
和 移 除 元 素 
6.4 元 组 
实例 201 Tuple 类 的 使 用 
【导语 】 


简单 地 说 ,元 组 就 是 将 一 组 松散 的 对 象 简单 地 组 合 在 一 起 。 元 组 比 数组 的 灵活 性 略 强 ， 
因为 数组 中 所 有 元 素 的 类 型 是 统一 的 ,而 元 组 使 用 了 泛 型 参数 ,使 得 每 个 元 素 的 类 型 相互 独 
立 。 元 组 不 同 于 类 和 结构 ,类 和 结构 是 高 度 整合 的 数据 类 型 ,其 中 要 实现 各 种 复杂 的 功能 ; 
元 组 只 是 一 系列 单一 对 象 的 简单 组 合 ,不 存在 复杂 的 操作 。 


| 


.NET 框架 最 早 引 入 元 组 的 概念 ,是 通过 Tuple 类 实现 的 ,而 且 存在 多 个 泛 型 版 本 ,可 
容纳 元 素数 量 为 1 一 8 个 。 元 组 中 将 所 有 元 素 分 配给 Item * 属性 ,其 中 x 表示 序号 ,例如 
Iteml Item2 Item3 等 ,Item * 属性 个 数 取决 于 元 素 的 个 数 。 

创建 元 组 实例 有 两 种 方法 : 

(1) 直接 调用 泛 型 版 本 Tuple 类 构造 函数 。 例 如 要 创建 一 个 三 元 组 , 即 可 以 组 合 三 个 
对 象 的 元 组 ,并 按 下 列 格式 实例 化 。 


Tuple < int, long, char> t = new Tuple< int, long, char >(1000, 20000L, 'p'); 


以 上 代码 创建 了 三 元 组 实例 ,其 中 ,Iteml 是 int 类 型 ,Item2 是 long 类 型 ,Item3 是 
char 类 型 。 
(2) 直接 调用 Tuple 类 的 Create 方法 ,此 方法 为 静态 方法 ,格式 如 下 。 


var k = Tuple.Create<byte，string>(255，"full"); 

以 上 代码 创建 了 一 个 二 元 组 实例 ,Iteml 为 byte 类 型 ,Item2 为 string 类 型 。 方 法 返 
-个 Tuple < T1，T2 > 对 象 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 创建 三 元 组 实例 ,元素 类 型 都 是 string。 


Tuple < string, string, string> tl = new Tuple < string, string, string > ("make", "it", 


加 


"easy"); 
步骤 3: 输出 三 元 组 中 Iteml、Item2 和 Item3 的 数据 类 型 与 对 应 的 值 。 


Console. WriteLine(" 三 元 组 :"); 

string msg = $"{nameof(t1. Item1)}:{t1. Iteml. GetType(). Name} = {tl1.Itenl}\n{nameof(t1. 
Item2) } :{t1. Iten2. GetType(). Name} = {t1.Iten2}\n{nameof(t1. Item3)}:{t1. Iten3. GetType(). 
Name} = {t1.Item3}"; 

Console. WriteLine(msg); 


步骤 4: 再 创建 一 个 二 元 组 ,元 素 类 型 分 别 为 nt 和 uint。 
Tuple< int，uint > t2 = new Tuple< int, uint >(70000, 950000); 
步骤 5: 输出 二 元 组 中 Iteml 和 Item2 的 数据 类 型 与 对 应 的 值 。 


Console.WriteLine("\n 二 元 组 :") 

msg = $"{nameof(t2.Item1)}:{t2. Itenml. GetType(). Name} = {t2. 
Itemi}\n{ nameof (t2. Item2)}:{t2. Item2. GetTYpe( ). Nane} tt2. 
Item2}"; 2 = 950000 
Console.WriteLine(msg) 


步骤 6: 运行 应 用 程序 项 目 ,控制 台 输出 的 信息 如 图 6-29 图 6-29 输出 两 个 元 组 
所 示 。 的 相关 信息 
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实例 202 ”推荐 使 用 的 元 组 一 一 ValueTuple 


【导语 】 

ValueTuple 的 使 用 方法 与 Tuple 类 似 ,但 ValueTuple 是 值 类 型 ,不 需要 分 配 堆 内 存 ， 
效率 更 优 于 Tuple 类 。 此 外 ,ValueTuple 的 Item * 成 员 都 是 公共 字段 ,这 使 得 ValueTuple 
在 初始 化 之 后 仍然 可 以 修改 元 素 。 

与 Tuple 类 一 样 ,ValueTuple 也 有 两 种 初始 化 方法 : 一 种 是 直接 调用 构造 函数 初始 
化 ; 另 一 种 是 调用 静态 的 Create 方法 直接 获得 元 组 实例 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 创建 四 元 组 ,元 素 类 型 分 别 为 short、uint、ulong 和 string。 


ValueTuple < short, uint, ulong, string> tl = ValueTuple. Create< short, uint, ulong, string> 
(160, 300, 50000000UL, "head"); 


步骤 3: 使 用 StringBuilder 类 组 装 要 输出 的 元 组 信息 ,包括 Item * 字段 的 类 型 和 具体 
内 容 。 


tringpuilder strbd = new tringbuildert()s 
strbd. AppendLine(" 四 元 组 :"); 
strbd. AppendFormat (" {0}: {1} 
Iteml) ; 
strbd. AppendFormat (" {0}: {1} 
Item2) 
strbd. AppendFormat (" {0}: {1} 
Item3); 
strbd. AppendFormat (" {0}: {1} 
Item4); 


步骤 4: 再 创建 二 元 组 ,元 素 类 型 为 bool 和 byte。 


Il 


{2}\n", naneof(t1. Iteml )，t1. Ttem1. GetType( ). Name, t1. 


上 


{2}Nn"，nanmeof (tl1. Item2), t1. Ttem2. GetType().Name, t1. 


上 


{2}\n", nameof(t1. Item3), t1. Item3. GetTYpe( ). Name, t1. 


上 


{2}Nn"，nameof (t1. Item4), t1. Ttem4. GetType( ). Name, t1. 


Wueluple <bool, byte> 2 = Yaluerople. Greate <bool, bvteS(false, 100); 
步骤 5: 向 StringBuilder 对 象 追加 Item * 字段 的 信息 。 


strbd. AppendLine("\n\n 二 元 组 :"); 
strbd. AppendFormat (" {0}: {1} 
Iteml ) 7 
strbd. AppendFormat (" {0}: {1} 
Item2) ; 


步骤 6: 尝试 修改 二 元 组 中 Item2 字段 的 值 。 


{2}\n", naneof(t2. Iteml ) t2. Ttem1. GetTYpe( ). Name, t2. 


上 


{2}\n", nameof (t2. Item2 ) ，t2. Item2. GetType( ). Name，t2. 


t2. Iten2 = 210; 
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| 


步骤 7: 将 修改 后 的 新 值 也 追加 到 StringBuilder 对 
象 中 。 


strbd. RppendFormat(" 修 改 后 , {0} = {1}"，nameof(t2. Item2), 
t2. Item2) 7 


步骤 8: 将 StringBuilder 对 象 中 的 字符 串 全 部 输出 到 控 
制 台 。 


Console. WriteLinel( strbd); 


图 6-30 输出 ValueTuple 


步骤 9: 运行 应 用 程序 ,输出 结果 如 图 6-30 所 示 。 的 Item * 字段 信息 
实例 203 C# 语 法 中 的 ValueTuple 
【导语 】 


ValueTuple 结构 得 到 C# 语 法 的 支持 ,可 以 使 用 简洁 的 语法 在 代码 中 直接 声明 元 组 。 


var a = (100, (byte)15, true); 

也 可 以 在 声明 时 明确 ValueTuple 的 类 型 。 
ValueTuple < string, string> b = ("Jack", "Bob"); 
还 可 以 选择 更 简洁 的 方式 声明 。 

(long, uint) f = (123454321L, 7899); 


【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 三 元 组 并 初始 化 ,元 素 类 型 分 别 为 string、string 和 byte。 
(string, string, byte) x = ("subject", "body", 26); 


步骤 3: 输出 三 元 组 中 Item * 字段 的 值 。 


Console. WriteLine(" 三 元 组 :\nIteml = {0}\nItem2 = {1}\nItem3 = {2}\n", x.Iteml, x.Item2, 
x. Item3); 


步骤 4: 再 声明 一 个 二 元 组 ,初始 化 时 直接 用 两 个 DateTime 实 
~^， 例 填充 ,编译 时 会 自动 推断 出 该 二 元 组 的 元 素 类 型 均 为 DateTime。 


var y = (new DateTime(2017, 1, 1), new DateTime(2018, 1, 1)); 


步骤 5: 输出 二 元 组 中 Item * 字段 的 值 。 


v Console.WriteLine(" 二 元 组 :\nIteml = {0:d}\nItem2 = {1:d}", y. 


Iteml, y. Item2); 
图 6-31 输出 两 个 元 组 
中 各 字段 的 值 步骤 6: 运行 应 用 程序 项 目 ,控制 台 输 出 内 容 如 图 6-31 所 示 ， 
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实例 204 重 命名 元 组 的 字段 


【导语 】 

在 .NET 基础 类 型 中 ,ValueTuple 结构 的 字段 都 以 Item * 来 命名 ,这 样 在 编写 代码 时 
并 不 方便 ,因此 基于 C# 语 言 编译 器 支持 对 元 组 中 的 字段 使 用 自 定义 命名 。 但 在 运行 阶段 ， 
依然 是 以 ValueTuple 为 基础 的 ,为 字段 重 命 名 仅仅 是 编程 语言 的 功能 。 

例如 ,以 下 代码 声明 三 元 组 。 


(int ID, string Title, string Body) v = (1, "demo", "some one" ) ; 


此 时 ,Iteml 字段 被 重 命名 为 ID,Item2 字段 被 重 命名 为 Title, Item3 字段 被 重 命名 为 
Body。 在 访问 时 ,可 以 直接 使 用 自 定义 的 字段 名 。 


vy.Title = "the best"; 


也 可 以 用 var 关键 字 先 声明 元 组 ,初始 化 时 再 重 命名 字段 。 


varw = (Count: 999, Symb: '* '); 


以 上 代码 中 ,编译 器 会 根据 赋值 推断 出 Count 字段 为 int 类 型 ,Symb 字段 为 char 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 ， 

步骤 2: 声明 二 元 组 ,元 素 类 型 都 是 double。 

(double x, double y) d = (0.000025d, 3.115d); 

步骤 3: 将 元 组 中 的 字段 相 乘 ,并 输出 计算 结果 。 

Console. WriteLine("x * y = {0}", d.x * d.y); 

步骤 4: 为 了 验证 元 组 的 基础 类 型 为 ValueTuple, 可 以 通过 反射 技术 输出 元 组 中 各 个 
字段 在 运行 时 的 名 称 以 及 所 属 的 数据 类 型 。 

// 运行 时 类 型 

TYpet = d.GetType(); 

// 获取 字段 列表 

var fds = t.GetFields(BindingFlags.Public | BindingFlags. Instance) ; 


Console. WriteLine(" 元 组 的 运行 时 类 型 :{0}"，t. Name); 
string infos = string. Empty; 


foreach (var f in fds) 
{ 
infos += $"{f.Name}:{f.FieldType. Name}\n"; 
} 
Console. WriteLine(" 各 字段 名 称 与 类 型 :\n{0}"，infos); 
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步骤 5: 运行 应 用 程序 ,输出 结果 如 图 6-32 所 示 。 从 输出 内 容 可 以 看 出 ,元 组 的 实际 类 
型 是 ValueTuple<T1, T2 >。 尽 管 在 代码 中 对 字段 进行 了 重 命名 ,而 其 实际 字段 名 称 依然 


是 Iteml 和 Item2。 


图 6-32 输出 元 组 在 运行 时 的 实际 类 型 


实例 205 ”将 元 组 解构 为 变量 

【导语 】 

声明 元 组 时 ,如 果 不 使 用 变量 名 , 则 编译 器 会 将 元 组 中 的 各 个 字段 自动 解构 为 单独 的 变 
量 , 其 语法 如 下 。 

(< 类 型 > < 字段 >, < 类 型 > < 变量 >，… … ) = ( < 为 字段 分 配 的 值 > ); 

这 样 声 明之 后 ,元 组 中 的 每 个 字段 都 可 以 作为 单独 的 变量 被 访问 。 当 然 也 可 以 用 var 
关键 字 来 声明 。 

var ( < 字段 列表 > ) = ( < 为 字段 赋值 > ); 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2; 声明 三 元 组 ,并 让 字段 解构 为 变量 。 


(long BookID, string BookName, string Muthor) = (10000031L, "Sample Book", "Tommy"); 
步骤 3: 输出 各 字段 的 内 容 。 

Console. WriteLine( $ "编号 :{BookID}\n 书 名 :{BookName}\n 作者 :{Author}"); 

解构 之 后 ,元 组 中 的 字段 可 作为 普通 变量 来 使 用 。 

步骤 4: 运行 应 用 程序 项 目 ,控制 台 输出 内 容 如 下 。 

编号 :10000031 

书 名 :Sample Book 

作者 :Tommy 

实例 206 解构 自 定义 类 型 

【导语 】 

C# 语 言 的 元 组 还 支持 将 用 户 自 定义 的 类 型 进行 解构 , 即 可 以 将 某 个 类 的 属性 解构 为 
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元 组 。 使 类 型 支持 解构 为 元 组 的 方法 是 : 在 类 型 中 定义 一 个 公共 方法 ,返回 类 型 为 void, 必 
须 将 方法 命名 为 Deconstruct。 组 成 新 元 组 的 元 素 由 Deconstruct 方法 的 out 参数 决定 ， 
个 类 型 中 可 以 定义 多 个 Deconstruct 方法 以 解构 出 不 同 元 素 个 数 的 元 组 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 自 定义 类 。 


public class Order 

{ 
public int OID { get; set; } 
public string CustomName { get; set; } 
public string ContactName { get; set; } 
public float Amount { get; set; } 
public string PhoneNo { get; set; } 

} 


步骤 3: 在 Order 类 中 定义 Deconstruct 方法 .将 Order 类 的 五 个 属性 进行 解构 。 


public void Deconstruct(out int oid, out string custName，out string contact, out float anmount, 
out string phone) 
{ 

oid = OID; 

CustName = CustomName; 

contact = ContactName; 

amount = Amount; 

phone = PhoneNo; 


} 
步骤 4: 在 Main 方法 中 实例 化 一 个 Order 对 象 ,并 对 属性 进行 初始 化 。 


Order o = new Order 


{ 
OID = 6012001, 
CustomName = "XXX 贸易 有 限 公司 "， 
ContactName = " 刘 先 生 "， 
Rmount = 1700.34f, 
PhoneNo = "13322500121" 


}; 

步骤 5: 对 Order 实例 进行 解构 。 
var (id, cust, contact, amout, phone) = 0o; 二 
步骤 6: 输出 解构 后 的 元 组 字段 ， 


Console. WriteLine( $ "订单 号 :{id}\n 客户 单位 :{fcust}\n 联系 
人 :{contact}\n 订购 数量 : {amout}\n 电话 :{phone}"); 


步骤 7: 运行 应 用 程序 项 目 ,输出 结果 如 图 6-33 所 示 。 ”图 6-33 输出 解构 后 变量 的 值 
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实例 207 将 元 组 作为 返回 值 


【导语 】 

元 组 的 另 一 个 作用 一 一 充当 方法 的 返回 值 。 尤 其 是 在 一 个 方法 中 需要 同时 返回 多 个 对 
象 给 调用 方 的 时 候 ,虽然 可 以 使 用 out 参数 ,但 使 用 元 组 可 以 更 简洁 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 一 个 返回 三 元 组 的 方法 。 


日 


static (string, int, string) GetData() 
{ 
return ("Test 1", 35, "Test 2"); 


} 
该 方法 没有 对 元 组 中 的 字段 进行 重 命 名 ,因此 三 个 字段 的 名 字 分 别 为 : Iteml 、Item2、 


Item3 。 


步骤 3: 调用 上 述 方法 ,获取 返回 的 元 组 后 ,不 对 字段 重 命名 ,直接 输出 。 


var k = GetData(); 
Console. WriteLine(" 未 对 字段 重 命名 :"); 
Console. WriteLine("Iteml = {0}, Item2 = {1}, Item3 = {2}", k.Iteml, k.Item2, k.Item3); 


步骤 4: 也 可 以 在 获取 返回 的 元 组 后 ,对 字段 重 命名 。 


var (Mark1，Count，Mark2) = GetData() 

Console. WriteLine("\n 对 字段 进行 重 命名 :"); 

Console. WriteLine ( $ " {nameof (Mark1)} = {Markl}, {nameof (Count)} = {Count}, {nameof 
(Mark2)} = {Mark2}"); 


步骤 $: 在 Program 类 中 再 定义 一 个 方法 ,在 返回 二 元 组 时 , 重 命名 字段 。 


static (int Number1，int Nunber2) GetNumbers() 
{ 

Random rand = new Random(); 

return (rand. Next(0, 1000), rand. Next(0, 1000)); 
} 


步骤 6: 调用 方法 ,获取 返回 的 元 组 ,并 直接 访问 已 经 命名 的 字段 。 


var d = GetNumbers() 

Console. WriteLine("\n 返回 带 重 命名 字段 的 元 组 :"); 

Console. WriteLine ( $ " {nanmeof (d. Number1)} = {d. Number1l}, {nameof (d. Number2)} = {d. 
Number2}"); 
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步骤 7: 运行 应 用 程序 ,控制 台 输 出 结果 如 图 6-34 所 示 。 


图 6-34 获取 方法 返回 的 元 组 数据 


LINQ 与 动态 类 型 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。， LINQ 中 常见 的 扩展 方法 ; 
，LINQ 请 法 ; 

， 动态 类 型 。 


7.1 常见 的 扩展 方法 


实例 208 ” 求 最 大 值 与 最 小 值 


【导语 】 

使 用 Max 与 Min 两 个 扩展 方法 ,可 以 分 别 第 选 出 原 序列 中 的 最 大 值 与 最 小 值 。 这 两 
个 方法 的 应 用 目标 是 实现 了 IEnumerable < 本 > 的 对 象 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


using System. Linqg; 

步骤 3: 初始 化 一 个 int 数组 。 

int[] arrsrc = { 100, 58, 8, 91, 560, 27, 42 }; 

步骤 4: 分 别 调用 Max 和 Min 方法 求 得 最 大 值 与 最 小 值 。 
// 求 最 大 值 


int max = arrsrc.Max(); 
// 求 最 小 值 


int min = arrsrc.Min(); 
步骤 5: 向 控制 台 输 出 求 得 的 最 大 值 与 最 小 值 。 


Console. WriteLine(" 原 数组 元 素 :{0}"，string. Join("、", arrsrc)); 
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Console. WriteLine(" 其 中 ,最 大 值 为 :{0}, 最 小 值 为 :{1}", max, min); 
步骤 6: 运行 应 用 程序 ,输出 结果 如 下 。 


原 数 组 元 素 :100、58、8、91、560、27、42 
其 中 ,最 大 值 为 :560, 最 小 值 为 :8 


实例 209 求 工序 列表 中 最 长 的 加 工 周 期 


【导语 】 

Enumerable 的 许多 扩展 方法 都 带 有 一 个 Func<T, TResult > 委托 类 型 的 参数 ,可 以 通 
过 这 个 委托 参数 来 返回 要 进行 计算 的 目标 值 。 当 扩展 方法 被 调用 时 ,会 将 Enumerable 对 
象 中 的 每 个 元 素 都 传递 给 这 个 委托 , 即 每 访问 一 个 元 素 ,就 会 调用 一 次 该 委托 。 

本 实例 声明 一 个 WorkItem 类 , 它 表 示 一 道 与 工序 相关 的 信息 ,其 中 包含 工序 的 开始 时 
间 StartTime, 以 及 工序 的 结束 时 间 EndTime。 如 果 要 计算 一 个 工序 序列 中 最 长 的 加 工 周 
期 ,就 需要 使 用 Func<T, TResult > 委托 返回 EndTime 减 去 StartTime 的 结果 ,最 后 交 给 
Max 方法 去 筛选 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


using System. Ling; 


using System. Collections. Generic; 
步骤 3: 声明 Workltem 类 。 


public class WorkItem 
{ 
/// < summary> 
/// 工序 序号 
/// </summary> 
public int ID { get; set; } 
/// < summary> 
/// 工序 描述 
/// </summary> 
public string Desc { get; set; } 
/// < sunmary> 
/// 开始 时 间 
/// </summary> 
public DateTime StartTime { get; set; } 
/// < sunmary> 
/// 结束 时 间 
/// </summary> 
public DateTime EndTime { get; set; } 


第 7 章 LINQ 与 动态 类 型 | 其 251 


步骤 4: 在 Main 方法 中 实例 化 一 个 List 对 象 ,并 向 其 中 添加 5 个 WorkItem 对 象 , 详 见 
代码 清单 7-1。 


代码 清单 7-1 向 List 中 添加 WorkItem 对 象 


List< WorkItem > works = new List<WorkItem>(); 
works. Add( new WorkItem 
《 
ID = 1， 
Desc = "工序 a"， 
StartTime = new DateTime(2018, 5, 10, 8, 32, 16), 
EndTime = new DateTime(2018, 5, 13, 14, 20, 0) 
D; 
works. Add( new WorkItem 
{ 
ID = 2， 
Desc = "工序 B"， 
StartTime = new DateTime(2018, 5, 12, 7, 26, 15), 
EndTime = new DateTime(2018, 5, 12, 18, 24, 15) 
D; 
works. Add( new WorkItem 
{ 
We 
Desc = "工序 c"， 
StartTime = new DateTime(2018, 5, 17, 9, 45, 0) 
EndTime = new DateTime(2018, 5, 19, 20, 36, 4) 
D; 
works. Add( new WorkItem 
{ 
De= 
Desc = "工序 D"， 
StartTime = new DateTime(2018, 6, 1, 11, 0, 0), 
EndTime = new DateTime(2018, 6, 4, 16, 34, 0) 
D; 
works. Add( new WorkItem 
{ 
下 = 天 
Desc = "工序 E"， 
StartTine = new DateTime(2018, 7, 3, 7, 49, 0), 
EndTime = new DateTime(2018, 7, 5, 18, 17, 0) 
D; 


步骤 5: 求 得 最 大 加 工 周期 ,并 输 


Var max = works.Max(w => w.EndTime — w.StartTime); 


Console. WriteLine(" 最 长 加 工 周期 为 :{0: %d} 天 {0:%h} 时 {0:%m} 分 {0:% s} 秒 "，max); 
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步骤 6: 运行 应 用 程序 ,控制 台 输 出 内 容 如 下 。 
最 长 加 工 周期 为 : 3 天 5 时 47 分 44 秒 


实例 210 ”计算 字符 串 的 总 长 度 


【导语 】 

本 实例 将 通过 Sum 方法 计算 一 个 字符 串 数组 中 所 有 字符 串 的 长 度 总 和 。Sum 方法 所 
返回 的 类 型 一 般 为 数值 ,如 int、double、decimal、long、float 等 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


using Systenm. Ling; 
步骤 3: 声明 并 初始 化 字符 串 数组 。 


string[ ] arr = 
{ 

"effect", "teach", "table", "purpose", "transport" 
}; 


步骤 4: 计算 数组 中 所 有 字符 串 的 总 长 度 。 


int len = arr.Sum(x => x.Length); 


Console. WriteLine( $ "字符 串 总 长 度 :{len}"); 
步骤 5: 运行 应 用 程序 ,控制 台 输 出 内 容 如 下 。 


字符 串 总 长 度 : 32 
实例 211 合并 两 个 序列 
【导语 】 


Concat 扩展 方法 支持 将 当前 序列 与 方法 参数 中 另 一 个 指定 的 序列 进行 合并 .最 后 返回 
-个 新 的 序列 一 一 新 序列 中 包含 二 者 的 所 有 元 素 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 创建 两 个 List 实例 ,并 分 别 填充 元 素 。 


List< int> listl = new List< int> 
{ 

20; 21, 2 
}; 


List< int> list2 = new List < int> 
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23，24 
}; 


步骤 3: 将 以 上 两 个 列表 进行 合并 ,然后 输出 合并 后 新 列表 的 元 素 。 
var result = listl.Concat(list2); 


Console. WriteLine(" 合 并 后 的 列表 :"); 
Console. WriteLine( string. Join('\', result)); 


步骤 4: 运行 应 用 程序 ,控制 台 输出 内 容 如 下 。 


合并 后 的 列表 : 
L222 


实例 212 有 多 少 个 矩形 的 面积 超过 100cm 


【导语 】 

扩展 方法 Count 可 用 于 计算 序列 中 元 素 的 个 数 ,并 且 可 以 根据 指定 的 条 件 进 行 统计 。 
通过 Func< TSource，bool > 委托 来 给 定 统计 条 件 ,该 委托 的 输入 参数 为 原 序列 中 的 元 素 实 
例 ,返回 值 为 一 个 布尔 值 , 即 如 果 给 定 的 元 素 符合 统计 要 求 就 返回 true, 不 符合 就 返回 
false。 

本 实例 用 一 个 Rectangle 结构 来 表示 和 矩形 数据 ,包含 Width 和 Height 两 个 字段 。 然 后 
产生 一 个 矩形 序列 ,调用 Count 扩展 方法 来 统计 面积 大 于 100cm: 的 矩形 数量 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


using System. Collections. Generic; 


using System. Ling; 


步骤 3; 声明 Rectangle 结构 ,其 中 Width 字段 表示 宽度 ,Height 字段 表示 高 度 ,单位 都 


碟 cm。 


public struct Rectangle 
{ 
public float Width; 
public float Height; 
} 


步骤 4: 在 Main 方法 中 初始 化 Rectangle 数组 。 


Rectangle[ ] rects = 

{ 
new Rectangle{ Width = 16.002f, Height = 7f }， 
new Rectangle{ Width = 2.5f, Height = 4.74f }, 
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new Rectangle { Width = 1.5f, Height = 3.5f }, 

new Rectangle{ Width = 6.9f, Height = 12.3f }, 

new Rectangle{ Width = 0.8f, Height = 10.22f }, 

new Rectangle{ Width = 9.4f, Height = 21.3f }, 

new Rectangle{ Width = 6.5f, Height = 32.8f} 
B; 


注意 : 在 数值 常量 后 面 加 上 了 ,表示 一 个 单 精度 数值 。 


步骤 5: 求 得 面积 大 于 100cm? 的 矩形 个 数 。 

int count = rects. Count(r => (r.Width * r.Height) > 100f); 

步骤 6: 运行 应 用 程序 ,控制 台 输 出 内 容 如 下 。 

面积 大 于 100 平方 厘米 的 矩形 有 3 个 

实例 213” 按 员工 年 龄 进行 降序 排列 

【导语 】 

本 实例 运用 OrderByDescending 扩展 方法 对 一 个 表示 员工 信息 序列 中 的 元 素 进行 降序 
排列 , 即 按照 员工 年 龄 从 大 到 小 排序 。 

调用 OrderByDescending 方法 后 返回 的 对 象 类 型 为 IOrderedEnumerable < TElement > 接 
口 .开发 人 员 在 编写 代码 时 不 必 关 心 哪些 类 型 实现 了 该 接口 ,因为 框架 内 部 已 经 封装 好 。 该 接 
口 继承 了 IEnumerable 接口 ,因此 支持 使 用 foreach 循环 访问 序列 中 的 元 素 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


using System. Collections. Generic; 


using System. Ling; 
步骤 3: 定义 一 个 Employee 类 ,假设 它 封 装 了 员工 的 基本 信息 。 


public class Employee 
{ 
/// < summary> 
/// 员工 编号 
/// </summary> 
public int Eid { get; set; } 
/// < sunmary> 
/// 员工 姓名 
/// </summary> 
public string Ename { get; set; } 
/// < sunmary> 


/1// 员工 年 龄 
/// </summary> 


public int Eage { get; set; } 


. 
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步骤 4: 在 Main 方法 内 部 创建 一 个 以 Employee 为 元 素 类 型 的 List 实例 ,并 且 进行 初 


始 化 。 


List < Employee> emps = new List< Employee> 


i 
new Employee { Eid 
new Employee { Eid 
new Employee { Eid 
new Employee { Eid 
new Employee { Eid 
new Employee { Eid 
new Employee { Eid 

}; 


Ename = 
Ename = 
Ename = 
Ename = 
Ename = 
Ename = 


" 老 高 "，Eage 
" 老 刘 "，Eage 
" 老 张 "，Eage 
" 老 王 "，Eage 
" 老 陈 "，Eage 
" 老 姜 "，Eage 


Ename = " 老 徐 "，Eage 


28 }， 
42 }， 
27}, 
45 }, 
36}, 
46}, 
51} 


步骤 5: 调用 OrderByDescending 方法 ,按照 员工 年 龄 进行 降序 排列 。 


var result = emps.OrderByDescending(e => e. Eage); 


步骤 6: 输出 排序 后 的 员工 序列 。 
Console. WriteLine(" 将 员工 年 龄 按 降序 排列 :"); 


foreach (Employee emp in result) 


{ 


Console. WriteLine( $ "员工 编号 : {enp. Eid} ,员工 姓名 :{emp. Ename}, 员 工 年 龄 :{emp. Eage}"); 


} 


步骤 7: 运行 应 用 程序 项 目 ,控制 台 输出 的 信息 如 图 7-1 所 示 。 


CNProgram Files\dotnet\dotnet.exe 一 


图 7-1 


按 员 工 年 龄 降序 排列 


实例 214 ”去掉 重 复 的 元 素 


【导语 】 


本 实例 通过 使 用 Distinct 扩展 方法 ,去 除 int 数组 中 的 重复 元 素 。Distinct 方法 处 理 完 
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后 会 返回 新 的 序列 ,新 序列 中 不 包含 重复 的 元 素 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 初始 化 一 个 int 数组 ,其 中 包含 重复 的 元 素 。 


int[] arr = { 100, 150, 150, 32, 35, 35, 35 }; 
步骤 3: 去 除 重复 的 元 素 。 

IEnunerable < int > result = arr.Distinct(); 

步骤 4: 输出 前 后 两 个 序列 中 的 元 素 , 以 便 对 比 。 


Console. WriteLine(" 原 序列 元 素 :{0}"，string. Join('、', arr)); 
Console. WriteLine( "去除 重复 元 素 后 :{0}"，string. Join('、',， result)); 


步骤 5: 运行 应 用 程序 ,输出 内 容 如 图 7-2 所 示 。 


图 7-2 去 除 重复 的 元 素 


实例 215 ”筛选 出 两 个 序列 中 的 差异 元 素 


【导语 】 


当 序 列 A 调用 Except 扩展 方法 并 将 序列 B 作为 参数 传递 时 ,该 方法 将 筛选 出 序列 A 


中 与 序列 B 不 相同 的 元 素 ; 相反 地 ,如 果 序 列 B 调用 Except 扩展 方法 并 将 序列 A 传递 给 


方法 的 参数 ,那么 该 方法 将 筛选 出 序列 B 中 与 序列 A 不 相同 的 元 素 。 调 用 方法 后 得 到 的 返 


回 值 是 一 个 新 的 序列 ,里 面包 含 了 有 差异 的 元 素 。 
【操作 流程 】 
步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 引入 以 下 命名 空间 。 


using System. Ling; 
using System. Collections. Generic; 


步骤 3: 初始 化 两 个 uint 数组 。 


wint[] listl = { 1, 2 3 

uint[] list2 = {1,2,7,4, 8,61}; 

步骤 4: 分 别 调用 两 个 数组 实例 的 Except 扩展 方法 ,得 到 当前 数组 与 另 
差异 集 。 


-数组 之 间 的 
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IEnunerable < uint > result1 = listl.Except(list2); 
IEnunerable < uint > result2 = list2. Except(list1); 


步骤 5: 输出 两 个 差异 集中 的 元 素 。 


Console. WriteLine( "序列 1:{0}"，string.Join('' list1)); 
Console. WriteLine(" 序 列 2:{0}",，string. Join('', list2)); 
Console. WriteLine( "序列 1 中 与 序列 2 不 同 的 元 素 :{0}"， string. Join('',， result1)); 
Console. WriteLine( "序列 2 中 与 序列 1 不 同 的 元 素 :{0}",，string. Join('', result2)); 


步骤 6: 运行 应 用 程序 ,输出 结果 如 图 7-3 所 示 。 


Caprogramflles.. 一 口 x 
ppt 
4 


与 序列 1 不 同 的 元 雪 , 7 8 


图 7-3 两 个 数组 中 元 素 的 差异 


两 个 数组 中 存在 的 差异 元 素 有 3、5、7、8, 对 listl 数组 而 言 , 它 与 list2 数组 的 差异 元 素 
是 3 和 5; 对 list2 数组 而 言 , 它 与 listl 数组 的 差异 元 素 是 7 和 8。 


实例 216 “处理 First 方法 抛 出 的 异常 


【导语 】 

First 方法 的 作用 是 从 序列 中 取出 第 一 个 元 素 ,但 是 如 果 序 列 是 空 的 ,调用 First 方法 就 
会 发 生 异 常 。 解 决 方案 有 以 下 两 种 : 第 一 种 方案 是 将 调用 First 方法 的 代码 写 在 try…catch 
语句 块 中 , 显 式 捕 提 可 能 发 生 的 异常 ; 第 二 种 方案 是 调用 另 一 个 与 First 功能 相似 的 扩展 方 
法 一 一 FirstOrDefault, 这 个 方法 的 功能 也 是 从 序列 中 取出 第 一 个 元 素 , 但 是 如 果 序列 是 空 
的 ,就 会 返回 元 素 类 型 的 默认 值 。 例 如 ,如 果 元 素 类 型 是 int, 当 获取 不 到 元 素 时 ,方法 就 返 
回 0。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


using System. Collections. Generic; 
using System. Ling; 


步骤 3: 产生 一 个 空白 序列 ,元素 类 型 为 long。 
IEnumerable< long > empty = Enumerable. Empty< long >(); 


创建 一 个 空白 序列 的 方法 很 简单 ,直接 调用 Enumerable 类 的 静态 方法 Empty 即 可 。 
步骤 4: 尝试 调用 First 方法 获取 序列 中 的 第 一 个 元 素 。 
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try 
# 
long x = empty.First(); 
Console. WriteLine(" 第 一 个 元 素 :{0}",，x); 
} 
catch( Exception ex) 


{ 
Console. WriteLine( $ "错误 : {ex. Message}"); 
} 


由 于 序列 中 不 存在 元 素 ,调用 First 方法 就 会 发 生 异 常 ,推荐 的 做 法 是 把 代码 写 在 try… 
catch 语句 块 中 。 当 以 上 代码 被 执行 时 ,控制 台 会 输出 以 下 错误 信息 。 


错误 : Sequence contains no elements 


步骤 5: 通过 FirstOrDefault 方法 获取 序列 中 的 第 一 个 元 素 。 


longy = empty.FirstOrDefault(); 
Console. WriteLine(" 第 一 个 元 素 :{0}",，y); 


由 于 序列 为 空 ,无 法 获取 第 一 个 元 素 ,但 会 返回 long 类 型 的 默认 值 0, 因 此 控制 台 输 出 


以 下 信息 。 
第 一 个 元 素 : 0 
实例 217” 当 序列 中 有 且 仅 有 一 个 元 素 时 
【导语 】 


当 一 个 序列 中 有 且 仅 有 一 个 元 素 时 ,可 以 调用 Single 扩展 方法 来 返回 这 个 元 素 , 当然 
也 可 以 用 First 方法 来 返回 。Single 方法 与 First 方法 最 明显 的 区 别 是 : Single 方法 只 有 在 
序列 中 仅 有 一 个 元 素 时 候 有 效 ; 而 First 方法 是 不 管 序列 中 有 多 少 个 元 素 , 只 要 存在 元 素 就 
可 用 。 

如 果 序 列 为 空 或 者 元 素数 量 不 为 1, 调 用 Single 扩展 方法 会 抛 出 异常 ,也 可 以 调用 
SingleOrDefault 方法 来 避免 抛 出 异常 。 当 发 生 异 常 时 ,方法 将 返回 元 素 类 型 的 默认 值 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


using System. Collections. Generic; 
using System. Ling; 


步骤 3: 初始 化 一 个 List 实例 ,元 素 类 型 为 int, 并 且 列 表 中 只 有 一 个 元 素 。 
List< int> list = new List<int>{ 15}; 


步骤 4: 调用 Single 方法 ,获取 单个 元 素 。 
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int x = list.Single(); 


步骤 5: 运行 应 用 程序 ,输出 结果 如 下 。 


唯一 的 元 素 :15 
实例 218 ”筛选 出 手机 号 以 135 或 136 开头 的 联系 人 信息 
【导语 】 


Where 扩展 方法 可 用 于 从 序列 中 筛选 出 符合 条 件 的 元 素 , 组 成 新 的 序列 ,并 返回 给 调 
期 并 < 

本 实例 将 通过 Where 方法 从 联系 人 集合 中 筛选 出 手机 号 码 以 135 或 136 开头 的 联系 
人 对 象 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


using System. Collections. Generic; 
using System,. Ling; 


步骤 3: 声明 一 个 新 类 ,用 来 封装 与 联系 人 相关 的 信息 。 


public class Contact 
{ 
public int ContactID { get; set; } 
public string ContactName { get; set; } 
public string ContactEmail { get; set; } 
public string ContactPhoneNo { get; set; } 
} 


步骤 4: 在 Main 方法 中 声明 一 个 Contact 类 型 的 数组 ,并 填充 元 素 , 详 见 代码 清单 7-2。 
代码 清单 7-2 ”初始 化 Contact 数组 


Contact[] contacts = 
{ 
new Contact 
{ 
ContactID = 6501, 
ContactName =“" 小 何 "， 
ContactEmail = "abc@test. org", 
ContactPhoneNo = "13578921100" 
}, 
new Contact 


{ 
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ContactID = 6502, 
ContactName = "小 石 "， 
ContactEmail = "dede@sample.net"， 
ContactPhoneNo = "13498016676" 
}, 
new Contact 
和 
ContactID = 6503, 
ContactName =“" 小 陈 "， 
ContactEmail = "tisst@126.com", 
ContactPhoneNo = "13655614578" 
}, 
new Contact 
{ 
ContactID = 6504, 
ContactName = "小 黄 "， 
ContactEmail = "acc@163.com"， 
ContactPhoneNo = "13521347309" 


by 

new Contact 

{ 
ContactID = 6505, 
ContactName = "小 李 "， 
ContactEmail = "ckh(@126.net", 
ContactPhoneNo = "13340090078" 


new Contact 


ContactID = 6506, 

ContactName =“" 小 刘 "， 
ContactEmail = "fl89@nt.cn", 
ContactPhoneNo = "15882133255" 


上 


步骤 5: 调用 Where 方法 ,对 联系 人 序列 进行 筛选 。 


var result = contacts. Where(c = > c. ContactPhoneNo. StartsWith("135") | | c. ContactPhoneNo. 
StartsWith("136")); 


步骤 6: 将 筛选 结果 输出 到 控制 台 。 
Console. WriteLine(" 手 机 号 以 135 或 136 开头 的 联系 人 有 :"); 


foreach(Contact ct in result) 


{ 
Console.WriteLine( $ "\n 联系 人 编号 : {ct. ContactID}\n 联系 人 名 称 : {ct. ContactName} \n 联 
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系 人 电邮 :{fct. ContactEmail}\n 联系 人 手机 号 : {ct. ContactPhoneNo}"); 
} 


步骤 7: 运行 应 用 程序 ,输出 结果 如 图 7-4 所 示 。 


CNProgram Files\dotnet\d. — 口 x 


图 7-4 筛选 后 的 联系 人 序列 


实例 219 ”将 对 象 转换 为 字典 集合 


【导语 】 

ToDictionary 扩展 方法 比较 有 趣 , 它 可 以 将 序列 中 的 每 个 元 素 转换 为 Key-Value 对 
后 组 成 一 个 字典 集合 。 

本 实例 用 到 以 下 重 载 版 本 。 


Dictionary < TKey, TElement > TbDictionary < TSource, TKey, TElement > (this JEnumerable < TSource > 

source, Func< TSource，TKey> keySelector, Func < TSource, TElement > elementSelector); 

其 中 ,keySelector 参数 与 elementSelector 参数 都 是 委托 类 型 ,分 别 用 于 返回 作为 字典 
PP 元素 的 Key 和 Value。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


下 


using System. Collections. Generic; 
using System. Ling; 


步骤 3: 声明 一 个 类 , 它 表示 一 件 产 品 的 基础 信息 ，。 


public class Production 
{ 
/// < summary> 


/// 产品 编号 
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/// </summary> 

public int PID { get; set; } 

/// < sunmary> 

/// 产品 名 称 

/// </summary> 

public string Name { get; set; } 

/// < sunmary> 

/// 产品 尺寸 

/// </summary> 

public float Size { get; set; } 

/// < sunmary> 

/// 生产 数量 

/// </summary> 

public int Quantity { get; set; } 
} 


步骤 4: 在 Main 方法 中 声明 一 个 Production 数组 ,并 进行 实例 化 。 


Production[ ] prds = 
{ 
new Production 
{ 
PID = 4007, 
Name = "产品 1"， 
Size = 123.45f, 
Quantity = 65 
}, 
new Production 


下 
PID = 4008, 
Name = "产品 2"， 
Biee = T7101f, 
Quantity = 100 

}, 

new Production 

{ 
PID = 4012, 
Name = "产品 3"， 
Size = 45.13f, 
Quantity = 25 


] 


步骤 5: 调用 ToDictionary 方法 将 数组 中 的 Production 元 素 转换 为 字典 结构 的 数据 。 
其 中 ,PID 属性 将 作为 字典 的 Key,Name 属性 将 作为 字典 的 Value。 


IDictionary< int, string> dic = prds.ToDictionary(p => p.PID, p => p. Name); 
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步骤 6: 输出 新 生成 的 字典 集合 中 的 元 素 信息 。 
Console. WriteLine(" 转 换 得 到 的 字典 数据 :"); 


foreach(var kp in dic) 


{ 


Console. WriteLine("{0} — {1}", kp. Key, kp. Value); 


; 


CAPro,., 一 口 X 
到 的 字典 数据 : 
村 
mm 1 


图 7-5 生成 的 字典 数据 


步骤 7: 运行 应 用 程序 ,输出 结果 如 图 7-5 所 示 。 
实例 220 ”将 原始 序列 进行 分 组 


【导语 】 
要 将 原始 序列 中 的 元 素 进行 分 组 ,可 以 调用 GroupBy 扩展 方法 。 此 方法 有 多 个 重 载 版 
本 ,本 实例 使 用 了 以 下 重 载 的 形式 。 


IEnunerable < TResult > GroupBy < TSource, TKey, TResult >(this IEnumerable < TSource > source, 


Func < TSource, 


resultSelector); 


其 中 有 三 个 类 型 参数 : TSource 是 原始 序列 中 的 元 素 ,TKey 是 分 组 依据 (例如 按 某 对 


象 的 Age 


分 组 序列 中 的 元 素 类 型 。 
keySelector 委托 用 于 


属性 进行 分 组 , 昼 


Bb 么 TRKey 就 是 Age 


Tkey > keySelector, Func < TKey, IEnumerable < TSource >, TResult > 


属性 的 类 型 ),TResult 是 返回 给 调用 方 的 已 


F 产生 分 组 依据 , resultSelector 委托 则 用 于 产生 分 组 结果 。 


resultSelector 委托 有 两 个 输入 参数 : 第 一 个 参数 是 分 组 依据 , 即 该 分 组 的 “标题 ”; 第 二 个 
参数 是 隶属 该 分 组 下 的 元 素 所 组 成 的 子 序列 。 


在 本 实例 中 ,Student 类 表示 学 


总 ,代码 将 对 学 员 列 表 中 的 对 象 按照 他 们 各 自 所 参 


与 的 课程 分 组 ,例如 ,参与 学 习 C++ 语言 的 学 员 便 构 成 一 个 分 组 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 引入 以 下 命名 空间 。 


using System. Ling; 
using System. Text; 


步骤 3: 声明 Student 类 .表示 学 员 信 息 。 


public class Student 


{ 


public int ID { get; set; } 
public string Name { get; set; } 
public string Course { get; set; } 


} 


步骤 4: 在 Main 方法 中 实例 化 一 个 Student 数组 并 填充 一 些 示例 元 素 。 详 见 代码 清单 7-3。 
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代码 清单 7-3 用 于 示例 的 Student 数组 


Student[] stus = 
{ 

new Student 

{ 
ID = 201, 
Name = "小 王 "， 
Course = "C" 

}, 

new Student 

{ 
ID = 202, 
Name = "小 曾 "， 
Course = "CH+" 

}, 

new Student 

{ 
ID = 203, 
Name = "小 昌 "， 
Course = "CH+" 

}, 

new Student 

{ 
ID = 204, 
Name =“" 小 孙 "， 
Course = "C#" 

}, 

new Student 
ID = 205, 
Name = "小 ¥ 
Course = "C" 


}, 

new Student 
ID = 206, 
Name = "小 时”， 
Course = "C" 


} 

new Student 
ID = 207, 
Name = "小 苏 "， 
Course = "C#" 

}, 

new Student 

人 
ID = 208, 
Name = "小 梁 "， 
Course = "Delphi" 


}; 
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步骤 5: 调用 GroupBy 方法 ,按照 学 员 所 参与 的 课程 进行 分 组 。 


var result = stus. GroupByY(s = > s, Course，(gKey，gItems) = > (GroupKey: gkey, ItemCount: 
gItems. Count(), Items: gItems) ) 7 


调用 以 上 方法 后 ,产生 的 结果 类 型 是 三 元 组 序列 ,其 中 GroupKey 字段 表示 分 组 标题 ， 
ItemCount 字段 表示 该 分 组 下 学 员 数 量 ,Items 字段 表示 属于 该 分 组 的 学 员 列 表 。 
步骤 6: 输出 分 组 后 的 序列 信息 。 


Console. WriteLine(" 学 员 参 与 课程 汇总 :"); 
StringBuilder strbuilder = new StringBuilder(); 
foreach(var g in result) 


{ 


strbuilder. AppendFormat ("课程 :{0}\n", g. GroupKey); 
strbuilder. AppendFormat(" 参与 人 数 :{0}\n"，g. ItemCount); 
strbuilder. AppendLine(" 名 单 :"); 
foreach (Student s in g. Items) 
{ 
strbuilder. AppendFormat(" {0} — {1}\n", s.1D, s.Nane); 

} 

} 


Console. WriteLine( strbuilder); 

以 上 代码 使 用 了 StringBuilder 类 来 组 装 字 符 串 ,再 通过 
WriteLine 方法 进行 输出 。 图 7-6 分 组 后 的 学 员 信息 

步骤 7: 运行 应 用 程序 ,输出 结果 如 图 7-6 所 示 。 


7.2 LINO 语法 


实例 221 ”筛选 能 被 5 整除 的 整数 


【导语 】 

LINQ 请 句 以 from 子 句 开 头 , 以 select 子 句 结 尾 , 这 两 个 子 句 是 必要 元 素 。 在 from 于 
名 与 select 于 句 之 间 , 可 以 使 用 其 他 辅助 查询 的 子 句 ,如 where、orderby、group 等 。 在 使 用 
LINQ 请 法 的 代码 中 ,需要 引入 System. Lind 命名 空间 。 

要 从 序列 中 筛选 出 符合 条 件 的 元 素 , 应 当 在 select 子 句 之 前 使 用 where 子 句 。 一 个 查 
询 中 可 以 包含 多 个 where 子 句 ,而 且 where 子 名 后面 可 以 跟随 多 个 表达 式 , 表 达 式 的 计算 
结果 必须 为 布尔 值 。 

本 实例 将 演示 使 用 LINQ 语法 从 一 个 整数 序列 中 筛选 出 能 被 5 整除 的 元 素 , 即 与 5 进 
行 模 运 算 后 结果 为 0 的 元 素 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
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步骤 2: 初始 化 一 个 int 类 型 的 数组 。 
int[] arr = { 12, 15, 35, 32, 45, 77, 80, 63 }; 
步骤 3: 使 用 LINQ 语句 筛选 出 能 被 5 整除 的 元 素 。 


var res = fromn inarr 
where (n % 5) == 0 
select n; 


步骤 4: 输出 筛选 后 的 元 素 。 
Console. WriteLine(" 能 被 5 整除 的 元 素 有 :"); 


foreach(int x in res) 


{ 


Console. Write(" {0}", x); 图 7-7 能 被 5 整除 的 元 素 
} 


步骤 5: 运行 应 用 程序 ,输出 结果 如 图 7-7 所 示 。 

实例 222” 求 序列 中 元 素 的 平方 根 并 按 降序 排列 

【导语 】 

本 实例 中 查询 语句 的 处 理 有 两 个 步骤 : 首先 求 得 元 素 的 平方 根 ,实现 方 法 是 调用 Math 
类 的 Sqrt 方法 ; 然后 将 计算 结果 降序 排列 ,如 果 要 在 LINQ 语句 中 进行 排序 ,就 需要 在 
select 子 句 之 前 使 用 orderby 子 句 。 

orderby 子 句 用 法 如 下 。 


orderby < 排序 对 象 > ascending | descending 


ascending 关键 字 表 示 升 序 排列 ,此 为 默认 排序 方式 ,因此 如 果 要 按 升序 排列 ,可 以 省 略 
ascending 关键 字 。descending 关键 字 表 示 降 序 排列 ,由 于 降序 并 非 默 认 排 序 方式 ,所 以 不 
能 省 略 descending 关键 字 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 并 初始 化 一 个 double 数组 。 


double[ ] srcs = 
{ 


17.5d, 42.33d, 100d, 130d, 256d, 312.14d, 96.656d 
}; 


步骤 3: 使 用 LINQ 请 句 将 数组 中 元 素 的 平方 根 进行 降序 排列 。 


var q = from x in srcs 
let s = Math. Sqrt(x) 
orderby s descending 
select (x, s); 
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let 关键 字 可 以 在 查询 语句 内 部 声明 一 个 临时 变量 ,此 处 使 用 临时 变量 s 来 保存 元 素 x 
的 平方 根 计 算 结 果 。select 子 名 产生 一 个 二 元 组 ,其 中 第 一 个 字段 是 元 素 x, 第 二 个 字段 是 


计算 结果 s( 临 时 变量 )。 
步骤 4: 输出 查询 结果 。 


foreach (var n in q) 
{ 

Console. WriteLine("{0, — 10} —> {1, — 16}", n.x, 
ni 


} 


步骤 5: 运行 应 用 程序 ,输出 内 容 如 图 7-8 所 示 。 图 7-8 按 元 素 的 平方 根 降序 排列 


实例 223 select 子 句 返回 的 内 容 
【导语 】 


执行 LINQ 语句 查询 后 所 返回 的 元 素 类 型 取决 于 select 子 句 , 即 该 子 句 后 面 的 表达 式 


所 产生 的 结果 。 为 了 提高 查询 代码 的 灵活 性 ,一 般 不 建议 专门 为 查询 结果 定义 新 类 型 ， 
查询 语句 产生 的 结果 多 数 情况 下 是 动态 的 。 
本 书 推荐 使 用 以 下 两 种 返回 类 型 : 


因为 


(1) 最 为 经 典 的 做 法 一 一 返回 匿名 类 型 。 匿 名 类 型 的 类 型 名 称 由 编译 器 自动 分 配 ,在 
编写 代码 期 间 , 开 发 人 员 是 无 法 得 知 其 类 型 名 称 的 。 只 需要 使 用 new 运算 符 对 匿名 类 型 进 


行 类 型 实例 化 ,并 对 类 型 属性 赋值 即 可 。 


(2) 可 以 考虑 返回 元 组 ,并 且 可 以 将 元 组 中 的 字段 重 命 名 为 有 意义 的 、 易 识别 的 名 称 。 
如 果 查 询 结 果 用 于 方法 返回 值 ,select 子 句 返回 元 组 是 比较 合理 的 ,因为 匿名 类 型 是 动态 生 
成 的 类 型 名 称 ,在 方法 的 返回 值 上 无 法 国定 类 型 名 。 过 去 的 做 法 是 将 方法 的 返回 类 型 设 定 
为 动态 类 型 (Dynamic) ,然后 把 查询 结果 赋值 给 动态 类 型 ,但 这 样 做 容易 输 错 代码 (访问 动 
态 类 型 没有 智能 提示 )。 但 结合 最 新 的 语言 特性 ,可 以 让 查询 返回 元 组 ,再 通过 方法 将 元 组 


返回 给 调用 方 ,这 种 做 法 可 以 弥补 匿名 类 型 不 能 确定 类 型 名 称 的 不 足 。 
本 实例 演示 了 LINQ 查询 的 三 种 返回 类 型 ,分 别 为 : 字符 串 、 匿 名 类 型 以 及 元 组 。 
【操作 流程 】 
步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 初始 化 一 个 日 期 /时 间 数 组 。 


DateTime[ ] dts = 
{ 


new DateTime(2016, 6, 12), 

new DateTime(2018, 4, 13), 

new DateTime(2001, 9, 21) 
}; 


步骤 3: 使 用 LINQ 查询 数组 中 的 日 期 ,并 以 短 日 期 字符 串 的 形式 返回 。 
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var gl = from d in dts 
select d. ToShortDatestring(); 


步骤 4: 声明 一 个 自 定义 类 ,命名 为 Person。 


public class Person 

{ 
public int ID { get; set; } 
public string Name { get; set; } 
public int Mge { get; set; } 

} 


步骤 5: 实例 化 一 个 Person 类 型 的 数组 。 


Eerson[ ] parr = 
{ 

new Person{ ID = 1，Nane =" 老 胡 ", Rge = 23 }， 
"老汉 ", Age = 30]， 
new Person{ ID = 3, Nane = " 老 余 ", age = 31】} 


上 


new Person{ ID = 2, Nane 


}; 


步骤 6: 通过 查询 返回 一 个 包含 匿名 类 型 的 结果 ,该 匿名 类 型 仅仅 引用 了 Person 对 象 
的 ID 和 Name 属性 的 内 容 。 


var q2 = from p in parr 
select new 
1 
PersonID = p.ID, 
PersonName = p. Name, 
}; 


注意 : 初始 化 匿名 类 型 时 ,如 果 属 性 名 称 与 原 对 象 的 属性 名 称 相 同 , 可 以 直接 引用 原 对 象 的 
属性 ; 否则 ,可 以 自 定义 新 的 属性 名 称 。 
步骤 7: 声明 一 个 字符 串 实例 。 
string s = "abcdef"; 


步骤 8: 由 于 该 字符 串 是 由 char 序列 组 合 而 成 的 ,所 以 可 以 将 string 对 象 视 为 char 类 
型 元 素 的 序列 进行 查询 操作 。 


varg3 = fromcins 
let index = s. IndexOf(c) 
select (Index: index, Char: c); 
在 查询 内 部 ,用 index 变量 临时 存放 字符 c 在 字符 串 s 中 的 索引 ,在 select 子 句 中 , 返 区 
二 元 组 ,包含 Index 和 Char 两 个 字段 。 
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在 foreach 循环 中 ,可 以 直接 访问 元 组 的 字段 。 


foreach (var i in q3) 
{ 
Console. WriteLine( $ "{i. Index} — '{i.Char}'"); 


} 
步骤 9: 运行 应 用 程序 ,控制 台 输出 结果 如 图 7-9 所 示 。 


图 7-9 用 select 子 句 确定 查询 所 返回 的 元 素 类 型 


实例 224 按 员 工 所 属 部 门 分 组 


【导语 】 

本 实例 假设 Employee 类 表示 某 公 司 的 员工 信息 ,其 中 ,Name 属性 是 员工 姓名 ， 
Department 属性 是 员工 所 属 的 部 门 。 随 后 将 员工 信息 序列 按照 部 门 进行 分 组 。 

在 LINQ 查询 中 对 序列 进行 分 组 需要 用 到 group… by 子 句 ,group 关键 字 之 后 是 要 进 
了 分 组 的 对 象 ,by 关键 字 之 后 是 分 组 标题 , 即 依据 什么 进行 分 组 。 

分 组 后 会 返回 一 个 实现 了 IGrouping 接口 的 对 象 实例 ,该 接口 也 继承 了 IEnumerable 
接口 成 员 ,使 得 代码 支持 枚 举 此 分 组 下 的 元 素 , 同 时 又 带 有 一 个 Key 属性 , 即 分 组 标题 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 Employee 类 。 


public class Employee 

{ 
public string Name { get; set; } 
public string Department { get; set; } 
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步骤 3: 初始 化 一 个 Employee 数组 。 


Employee[ ] emps = 

{ 
new Employee{ Name = "小 黄 "，Department = "财务 部 " }， 
new Employee{ Name = "小 卢 "，Department = "开发 部 " }， 
new Employee{ Name = "小 邢 "，Department = "开发 部 " }， 
new Employee{ Name = "小 陈 "，Department = "财务 部 "}， 
new Employee{ Name = "小 人"，Department =- "公关 部 " }， 
new Employee{ Name = "小 罗 "，Department = "仓储 部 " }， 
new Employee{ Name = "小 许 "，Department = "开发 部 " } 
new Employee{ Name = "小 田 "，Department = "仓储 部 "”} 


}; 
步骤 4: 通过 LINQ 查询 ,将 员工 信息 序列 按 部 门 名 称 分 组 。 


var q = from e in emps 
group e by e. Department 


步骤 5: 输出 分 组 后 的 序列 信息 。 


foreach (var g in qd) 
# 
Console. WriteLine("{0}:", g. Key); 
foreach (var emp in g) 
{ 
Console. WriteLine(" {0}", emp. Name); 
} 
Console. WriteLine( ); 


:i 


第 一 层 循环 是 读 取 单 个 分 组 数据 ,第 二 层 循环 是 访问 该 分 组 下 所 
包含 的 员工 信息 。 


步骤 6: 运行 应 用 程序 ,输出 内 容 如 图 7-10 所 示 。 


实例 225 “内 联 ” 查 询 
【导语 】 


图 7-10 分 组 后 的 
员工 信息 


使 用 join 子 句 可 以 将 当前 查询 的 序列 与 另 一 个 * 有 关系 ”的 序列 联合 起 来 进行 分 析 , 语 


法 如 下 。 


from a in < 当前 序列 > 
join b in < 另 一 个 序列 > on a. id equals b. pid 


select."* 


on 后 面 的 表达 式 是 两 个 序列 进行 关联 的 条 件 , 即 当前 序列 中 的 元 素 必须 有 某 个 属性 值 


与 男 一 个 序列 中 元 素 的 某 个 属性 值 相等 。 此 处 的 相等 判断 不 能 使 用 = 二 运算 符 , 应 当 使 用 
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equals 关键 字 , 这 是 LINQ 请 法 中 联合 查询 专用 的 关键 字 。 
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联合 查询 中 的 “内 联 "模式 是 这 样 的 ; 假如 有 两 个 序列 ,一 个 是 自行 车 列表 , 另 一 个 是 人 
员 列 表 。 每 辆 自行 车 都 有 它 的 主人 ,而 每 位 人 员 可 以 拥有 多 辆 自行 车 ,因此 人 与 自行 车 之 间 
形成 了 “一 对 多 ”的 关系 。 当 这 两 个 序列 进行 联合 查询 时 ,如 果 自 行车 序列 中 存在 与 人 员 序 
列 中 不 匹配 的 元 素 ,那么 这 个 元 素 ( 自 行车 ?就 不 会 被 查询 出 来 ,因为 它 与 人 员 序列 中 的 元 素 


(人 ) 没 有 对 应 关系 。 
本 实例 将 进行 这 样 的 演示 : 第 一 个 序列 为 课程 列表 ,第 二 个 序列 为 学 生 列表 。 


没有 被 选择 的 课程 不 会 出 现在 查询 结果 中 。 
【操作 流程 】 
步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 Course 类 ,表示 课程 信息 。 


JT 


public class Course 

{ 
public int ID { get; set; } 
public string Name { get; set; } 


} 
步骤 3: 声明 Student 类 .表示 学 生 信 息 。 


public class Student 
{ 
public string Name { get; set; } 
public int CourseID { get; set; } 
} 


步骤 4: 初始 化 课程 与 学 生 序列 。 


Course[ ] courses = 


{ 


new Course { ID = 301, Name = "HTML 5" }, 

new Course { ID = 302, Name = "C++" }, 

new Course { ID = 303, Name = "RSP.NET Core" }, 
new Course { ID = 304, Name = "PHP" }, 

new Course { ID = 305, Name = "Javascript" } 


[a 


Student[] students 
{ 


new Student { Name = "小 季 "，CourseID = 304}, 
new Student { Name = "小 吴 "，CourseID = 303 }， 
new Student { Name = "小 白 "，CourseID = 303 }， 
new Student { Name = "小 曹 "，CourseID = 302 }， 


new Student { Name = "小 解 "，CourseID = 302 } 


生 可 以 选择 多 门 课程 ,同样 也 存在 有 些 课 程 没有 学 生 选 择 的 情况 。 当 两 个 序列 联合 查询 时 ， 
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步骤 5: 联合 查询 两 个 序列 。 


var gr = from s in students 
join c in courses on s. CourseID equals c. ID 


select (StudentNane: s. Name，CourseName: c. Name) ; 
学 生 信 息 中 的 CourseID 属性 与 课程 信息 中 ID 属性 关联 , 即 课 程 编号 。 
步骤 6: 输出 查询 结果 。 


foreach (var x in qr) 
{ 

Console. WriteLine ( $ " {x. StudentName} 选 了 《{x. 
CourseName})"); 


步骤 7: 运行 应 用 程序 ,控制 台 输 出 结果 如 图 7-11 所 示 。 


7-11 学 生 选 课 信 息 查 询 结果 


注意 : 由 于 课程 "HTML 5 和 “Javascript” 没 有 被 选 ,在 学 生 序列 中 没有 对 应 关系 ,因此 不 会 
出 现在 查询 结果 中 。 


实例 226 ”处 理 查 询 中 的 异常 


【导语 】 

定义 LINQ 语 句 后 并 不 是 马上 执行 ,而 是 仅 保 存 查 询 指令 , 当 查 询 结 果 被 访问 时 ,查询 
才 会 真正 执行 。 因 此 ,如 果 要 处 理 LINQ 查询 中 可 能 发 生 的 异常 ,不 需要 把 LINQ 语句 放 在 
try…catch 代码 块 中 ,而 应 该 把 访问 查询 结果 的 代码 放 在 try…catch 代码 块 中 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 初始 化 一 个 int 数组 。 


int[] arrsrc = {1, 4, 8, 32}; 


步骤 3: 使 用 LINQ 语句 对 上 述 数 组 进行 查询 ,在 select 子 句 中 将 元 素 值 除 以 0。 


var q = from x in arrsrc 
select x / 0; 
由 于 0 是 不 能 做 除数 的 ,上 述 代码 自然 是 错误 的 ,但 是 执行 上 述 代码 时 并 不 会 抛 出 异 
常 ,因为 查询 并 未 真正 执行 ,只 有 当 查 询 结果 被 访问 时 才 会 执行 。 
步骤 4: 使 用 foreach 语句 访问 查询 结果 ,此 时 ,代码 应 当 写 在 try…catch 代码 块 中 , 当 
发 生 异 常 时 可 以 进行 捕捉 。 


try 
{ 


foreach(int i in q) 


{ 
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Console. WriteLine(i); 


} 
} 


catch( Exception ex) 


{ 


Console. WriteLine(" 错 误 信 息 :{0}",，ex. Message); 


} 
步骤 S: 
错误 信息 


运行 应 用 程序 ,得 到 的 结果 如 下 。 


: Attempted to divide by zero. 


实例 227 ”DefaultIfEmpty 方法 的 作用 


【导语 】 
Default 
值 ,例如 以 下 


fEmpty 方法 的 作用 是 : 当 某 个 序列 中 没有 元 素 时 ,将 返回 该 元 素 类 型 的 默认 
序列 。 


List< int> 1 = newList< int>(); 


此 时 , 列 
型 的 默认 值 ， 


表 中 没有 元 素 , 调 用 以 下 代码 返回 一 个 只 有 单个 元 素 的 序列 ,其 中 包含 int 类 
即 0。 


var e = 1.DefaultIfEmpty(); 


Default 


fEmpty 方法 一 般 用 于 联合 查询 中 , 当 第 二 个 序列 中 不 存在 与 第 一 个 序列 匹配 


的 元 素 时 将 返回 元 素 的 默认 值 , 以 保证 第 一 个 序列 中 的 元 素 能 够 全 部 查询 出 来 , 即 * 左 外 联 ” 


查询 。 


本 实例 将 定义 两 个 序列 : 一 个 是 订单 序列 (Order 类 表示 ) , 另 一 个 是 订单 详细 数据 序 
列 (OrderDetails 类 表示 ) ,而 Order 类 中 的 Details 属性 会 引用 一 个 关联 的 OrderDetails 实 
例 。 在 两 个 序列 联合 查询 时 ,一旦 订单 详细 数据 序列 中 不 存在 与 Details 属性 匹配 (Details 


属性 为 null) 
【操作 流 
步骤 1: 
步骤 2: 


的 元 素 , 就 返回 一 个 固定 的 OrderDetails 实例 作为 默认 值 。 
程 】 

新 建 一 个 控制 台 应 用 程序 项 目 。 

声明 OrderDetails 类 ,表示 订单 详细 信息 。 


public class OrderDetails 


{ 
publ 
publ 
publ 
} 


步骤 3: 


ic int Amount { get; set; } 
ic decinmal Price { get; set; } 
ic string Code { get; set; } 


声明 Order 类 ,表示 订单 信息 ,其 中 Details 属性 引用 OrderDetails 实例 。 
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public class Order 
和 
public ;int ID { get; set; } 
public DateTime Date { get; set; } 
public bool State { get; set; } 
public OrderDetails Details { get; set; } 


} 
步骤 4: 实例 化 两 个 OrderDetails 对 象 。 


OrderDetails dl = new OrderDetails 
{ 

amount = 10, 

Bripe = 2,5M; 

Code = "T—70770" 
}; 
OrderDetails d2 = new OrderDetails 
{ 

Mmount = 12, 

Brice = 3.2M, 

Code = "T—70778" 
}; 


步骤 5: 实例 化 三 个 Order 对 象 。 第 三 个 Order 实例 的 Details 属性 没有 引用 任何 
对 象 。 


Order ol = new Order 
{ 
1 
Date = new DateTime(2018, 3, 1), 
State = true, 
Details = dl 
}; 
Order o2 = new Order 
{ 
De= 2, 
Date = new DateTime(2018, 3, 13), 
State = false, 
Details = d2 
}; 
Order o3 = new Order 
{ 
B= 3 
Date = new DateTime(2018, 3, 18), 
State = true, 
Details = null 
}; 
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步骤 6: 声明 两 个 List 集合 ,用 于 存放 以 上 对 象 。 


List< Order > orders = new List<Order> { ol, o2，o3 }; 
List< OrderDetails > details = new List <OrderDetails> { dl, d2 } 


步骤 7: 对 上 述 两 个 序列 进行 联合 查询 。 


var q = fron o in orders 

join d in details on o.Details equals d into g 

fron x in g.DefaultIfEnpty(new OrderDetails { Amount = 0, Price = 0.00M, Code = "未 
知 编码 ”}) 

select (OrderID: o.ID, Amout: x. Mnount, Code: x.Code); 


当 没 有 匹配 项 时 ,产生 一 个 固定 的 OrderDetails 对 象 作为 默认 值 ,其 中 Amount 属性 为 
0,Price 属性 为 0.00,Code 属性 为 “未 知 编码 ”。 
步骤 8: 输出 查询 结果 到 控制 台 。 ] 


foreach (var i in q) 


{ 
Console. WriteLine("{0, —11}{1, ~- 10}{2, ~ 20}", 
i.OrderID, i.Amout, i.Code); 


} 图 7-12 “ 左 外 ”联合 查询 的 结果 
步骤 9: 运行 应 用 程序 ,输出 结果 如 图 7-12 所 示 。 


实例 228 使 用 LINQ 将 序列 转换 为 XML 文档 


【导语 】 

本 实例 将 演示 如 何 通 过 LINQ 查询 ,把 一 个 Account 类 型 的 序列 转换 为 XML 文档 。 
要 将 查询 结果 转换 为 XML 格式 ,关键 是 运用 select 子 句 。select 子 名 之 后 可 以 产生 一 个 
XElement 对 象 ,作为 XML 元 素 的 包装 ,在 XElement 内 还 可 以 艇 套子 元 素 或 者 使 用 
XAttribute 来 定义 XML 特性 。 

XML 文档 一 般 需 要 根 元 素 , 所 以 在 LINQ 查询 生成 XML 元 素 序列 后 ,还 要 用 一 个 单 
独 的 XElement 实例 来 包装 ,以 作为 XML 文档 的 根 元 素 , 最 后 再 把 这 个 根 元 素 实 例 传递 给 
XDocument 类 的 构造 函数 ,最 终 形成 一 个 完整 的 XML 文档 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Account 类 ,模拟 用 户 信 息 。 


public class Account 
{ 
/// < summary> 
/// 用 户 ID 
/// </summary> 
public int UserID { get; set; } 
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/// < summary> 
/// 用 户 名 
/// </summary> 
public string UserName { get; set; } 
/// < sunmary> 
/// 用 户 密码 
/// </summary> 
public string Password { get; set; } 
/// < sunmary> 
/// 是 否 为 管理 员 
/// </summary> 
public bool IsAdmin { get; set; } 
} 


步骤 3: 在 Main 方法 中 实例 化 一 个 Account 数组 。 


Account[] accs = 
{ 
new Account 
{ 
UserID = 1, 
UserName = "user 1", 
Password = "123", 
IsAdmin = false 
上 
new Account 


{ 


UserID = 2, 
UserName = "user 2", 
Password = "678", 


IsAdmin = false 
}, 


new Account 

{ 
UserID = 3, 
UserName = "user 3", 
Password = "hjk", 
IsAdmin = true 


}; 

步骤 4: 使 用 LINQ 语句 查询 上 述 数 组 中 的 所 有 元 素 并 产生 XElement 实例 。XML 元 
素 名 称 为 account, 而 Account 实例 的 属性 分 别 对 应 着 user_id、user_name、password 和 is_ 
admin 四 个 XAttribute 实例 。 


var elements= froma inaccs 
select new XElement ("account", 
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new XAttribute( "user_id", a.UserID), 

new XAttribute("user name", a.UserName), 
new XAttribute( "password", a, Password), 
new XAttribute("is_admin", a, Ishdmin)); 


步骤 5: 创建 文档 根 元 素 ,元 素 名 称 为 accounts, 用 以 包装 上 述 代 码 所 产生 的 XML 元 
素 序列 ,最 后 用 于 初始 化 XML 文档 。 


// 创建 文档 的 根 元 素 

XElenment root = new XElement("accounts", elements); 
// 创建 文档 对 象 

XDocument doc = new XDocument(root); 


步骤 6: 运行 应 用 程序 ,转换 得 到 如 下 的 XML 文档 。 


<accounts> 
<account user_ id= "1" user name= "user 1" password= "123" is admin = "false" /> 
<account user_id = "2" user_name = "user 2" password= "678" is_admin = "false" /> 
<account user_id= "3" user name= "user 3" password= "hjk" is admin= "true" /> 


</accounts> 


实例 229 ”将 分 组 后 的 序列 重新 排序 


【导语 】 
group 子 句 可 以 搭配 into 关键 字 , 暂 时 存放 已 经 分 好 组 的 元 素 ,例如 : 
group x by x.Type into gs 
其 中 ,gs 就 是 保存 该 分 组 序列 的 临时 变量 名 。 
在 完成 对 数据 序列 的 分 组 后 ,可 以 通过 嵌 套 一 个 LINQ 查询 对 组 内 元 素 进行 重新 排序 ， 
例如 : 
from a in someList 
group a by a. TYpe into gk 
let q2 = (fromb in gk orderby b select b) 
select new { Key = gk.Key, SubItens = q2 }; 
其 中 ,临时 变量 q2 所 引 有 的 就 是 一 个 嵌 套 的 LINQ 查询 。 
【操作 流程 】 
步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 初始 化 一 个 string 类 型 的 数组 。 
string[ ] arrsrc = 
{ 
"at", "act", "market", "fable", "also", "alt", "bee", "back", "book", "build", "face", 
"full", "fish", "food", "find", "meet", "make", "moo", "muklek" 
}; 
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步骤 3: 将 以 上 数组 中 的 单词 按 首 字母 进行 分 组 ,并 对 组 内 的 单词 重新 排序 。 


var q = from s in arrsrc 
group s by s[0].ToString().ToUpper() intog 
orderby g. Fey 
letnq = (fromw ing 
orderbyw 
select w) 


select (Key: g.Key, Items: nq); 
步骤 4: 输出 查询 结果 。 


foreach (var t in q) 

L 
Console. WriteLine(t. Key); 
foreach (var sub in t. Items) 


{ 


Console. WriteLine(" {0}", sub); 


. 
步骤 5: 运行 应 用 程序 ,输出 内 容 如 下 。 


a 
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实例 230 ”将 字典 集合 转换 为 字符 串 序列 


【导语 】 

使 用 LINQ 语句 查询 字典 集合 ,可 以 通过 select 子 句 把 字典 集合 中 的 键 / 值 对 转换 为 字 
符 串 序 列 。 

ee 

步骤 1: 全 全 人 和 轩 

步骤 2: ed 字典 集合 , 稍 后 用 于 做 转换 。 


IDictionary< string，int > dic = new Dictionary< string，int> 
{ 

["iten 1"] = 342, 

["item 2"] = 700, 

["item 3"] = 800 
}; 


步骤 3: 使 用 LINQ 查询 将 字典 集合 转 为 字符 串 序 列 。 


var g = fronp in dic 
select $ "{p.Key} : {p. Value}"; 


步骤 4: 输出 转换 之 后 的 字符 串 序 列 。 


foreach(string i in q) 
和 


Console. WriteLine(i) 7 


} 图 7-13 从 字典 转换 而 来 的 字符 串 
步骤 5: 运行 应 用 程序 项 目 ,结果 如 图 7-13 所 示 。 


实例 231 修改 XML 元 素 的 内 容 


【导语 】 

本 实例 将 首先 演示 运用 LINQ 语句 查询 出 符合 条 件 的 XML 元 素 ,然后 对 该 元 素 中 某 
个 子 元 素 的 内 容 进行 修改 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 一 个 用 于 测试 的 XML 元 素 。 


§ 
XElement testel = new XElement("Productios", 
new XElement ("Product", 
new XElement("id", 1201), 
new XElement("desc", "产品 R")， 
new XElement("mode", 7)), 
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new XElement ("Product", 
new XElement("id", 1202), 
new XElement("desc"," 产 品 B")， 
new XElement("mode", 3))); 
} 


XElement 类 可 以 直接 用 于 产生 XML 元 素 , 如 果 
不 依赖 文档 相关 的 属性 ,可 以 不 与 XDocument 类 
关联 。 

步骤 3: 使 用 LINQ 语句 查询 出 mode 子 元 素 中 
内 容 为 3 的 Product 元 素 。 


var q = fronm x in testel. Elements() 
where (int)x.Element("mode") == 3 


select x; 
步骤 4: 修改 这 个 Product 元 素 下 面 desc 子 元 素 


的 内 容 。 


if(q.Count() > 0) 
{ 
XElement e = q.First(); 
e. Element("desc").Value = "产品 6"; 
} 
访问 元 素 实 例 的 Value 属性 可 以 修改 该 元 素 中 
的 内 容 。 图 7-14 修改 前 后 的 XML 元 素 对 比 
步骤 5: 运行 应 用 程序 示例 ,输出 结果 如 图 7-14 
所 示 。 修 改 XML 元 素 后 ,“ 产 品 B” 已 经 变 成 “产品 G”。 


实例 232 ”使 用 并 行 LINQ 


【导语 】 

开启 LINQ 查询 的 并 行 模式 ,只 需要 在 原 序 列 上 调用 AsParallel 扩展 方法 ,但 是 不 应 该 
滥用 并 行 模式 。 如 果 查 询 的 量 很 小 ,并 且 在 查询 的 过 程 没 有 过 于 复杂 的 处 理 ,一 般 不 建议 使 
用 并 行 模式 。 

满足 以 下 条 件 的 查询 ,可 以 考虑 以 并 行 模式 执行 : 

(1) 序列 中 数据 量 很 大 。 

(2) LINQ 查询 中 where 与 select 子 句 上 需要 额外 的 处 理工 作 ( 例 如 要 转换 类 型 ) 。 

(3) 对 产生 的 结果 没有 严格 的 顺序 要 求 ( 尽 管 并 行 查询 可 以 调用 AsOrdered 扩展 方法 
来 维持 序列 的 顺序 ,但 在 一 定 程 度 上 会 降低 性 能 , 仅 在 必要 时 使 用 ) 。 

本 实例 将 定义 一 个 Rectangle 结构 , 它 表 示 一 个 矩形 的 信息 ,其 中 包含 宽度 和 高 度 两 个 
字段 。 实 例 代码 以 并 行 方式 生成 一 个 庞大 的 Rectangle 序列 ,然后 分 别 用 普通 和 并 行 两 种 模式 
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进行 LINQ 查询 ,最 后 分 别 统计 出 两 种 模式 下 执行 LINQ 查询 所 消耗 的 时 间 ( 单 位 是 ms) 。 
【操作 流程 】 
步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 定义 Rectangle 结构 。 


public struct Rectangle 
{ 
public double Width; 
public double Height; 
} 


步骤 3: 初始 化 Rectangle 序列 .本 例 使 用 ConcurrentQueue < T > 集合 来 包装 ,该 集 


支持 并 行 操作 ,并且 是 线程 安全 的 。 
ConcurrentQueue < Rectangle > testList = new ConcurrentQueue < Rectangle>() 7 
步骤 4: 以 并 行 方式 向 集合 中 添加 元 素 ， 


Parallel. For(20, 300000000, n => 
{ 
testList. Enqueue( new Rectangle 
Width = my 
Height = n 
D); 
DD); 


步骤 5: 分 别 以 普通 模式 .并行 模式 执行 LINQ 查询 ,在 select 子 句 中 计算 矩形 的 面积 。 


Stopwatch 组 件 的 作用 是 计算 执行 代码 所 耗费 的 时 间 , 详 见 代 码 清 单 7-4。 
代码 清单 7-4 ”两 种 模式 执行 LINQ 的 对 比 


Stopwatch watch = new Stopwatch( ) ; 
watch. Restart(); 
var ql = from x in testList 
Select x. Width * x.Height; 
watch. Stop(); 
Console. WriteLine(" 普 通 模式 , 耗 时 :{0} ms",， watch. ElapsedMilliseconds); 


watch. Restart( ); 
var q2 = from x in testList. AsParallel() 
Select x. Width * x.Height; 
watch. Stop( ); 
Console. WriteLine(" 并 行 模式 , 耗 时 :{0} ms"，watch.ElapsedMilliseconds); 


步骤 6: 运行 应 用 程序 ,输出 结果 如 图 7-15 所 示 。 
从 输出 结果 来 看 ,在 并 行 模式 下 执行 LINQ 查询 确实 提升 了 性 能 。 
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图 7-15 两 种 模式 耗 时 对 比 


注意 : Stopwatch 组 件 自身 在 运行 期 间 也 会 占用 一 定 的 CPU 资源 ,因此 该 组 件 所 统计 的 耗 
时 并 非 完 全 准确 , 仅 供 参考 。 


实例 233 ”将 XML 转换 为 元 组 


【导语 】 

LINQ 查询 语句 通常 是 通过 select 子 句 实现 数据 转换 的 。 本 实例 将 通过 LINQ 语句 查 
询 某 个 XML 元 素 下 的 子 元 素 列表 ,并 在 select 子 句 后 返回 二 元 组 ,元 组 中 的 字段 对 应 着 
XML 元 素 中 相应 Attribute( 特 性 ) 的 值 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2; 创建 XML 测试 数据 ,其 中 包含 一 个 Items 根 元 素 , 根 元 素 下 有 三 个 Item 元 素 ， 
每 个 元 素 中 带 有 两 个 特性 一 一 Vall 和 Val2。 


XElenment xml = new XElement("Items", 
new XElement ("Item", 
new XAttribute("Vall", 100), 
new XAttribute("Val2", 250)), 
new XElement ("Item", 
new XAttribute("Vall", 7500), 
new XAttribute("Val2", 900)), 
new XElement ("Item", 
new XAttribute( "Val1", 2003), 
new XAttribute( "Val2", 6230))); 


步骤 3: 用 LINQ 查询 上 述 XML 数据 中 的 Item 元 素 , 并 将 它 的 特性 值 转换 为 元 组 中 
的 字段 值 。 


也 


var q = from el in xm1.Elements("Item") 
let vl = Convert.ToInt32(el. RMttribute("Vall") .Value) 
let v2 = Convert.ToInt32(el. RMttribute("Val2") .Value) 
select (Value 1: v1，Value 2: v2); 
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步骤 4: 输出 元 组 序列 中 每 个 字段 的 值 。 


foreach(var t in q) 
{ 
Console. WriteLine( $ "Value 1 : {t.Value 1}\nValue 2 : {t.Value 2}\n"); 


} 
步骤 5: 运行 应 用 程序 项 目 ,输出 结果 如 图 7-16 所 示 。 


图 7-16 XML 数据 转换 为 二 元 组 


实例 234 ”生成 带 命名 空间 的 XML 文档 


【导语 】 

使 用 XElement 类 创建 XML 元 素 时 ,可 以 搭配 使 用 XNamespace 类 来 定义 XML 命名 
空间 。 将 XNamespace 实例 与 XML 元 素 的 名 字 直 接连 接 起 来 (如 同 用 “十 ”运算 符 拼接 字 
符 串 一 样 ) ,命名 空间 就 会 自动 与 元 素 关联 了 (XNamespace 类 内 部 实现 了 运算 符 重 载 ) 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 XML 命名 空间 。 


XNamespace ns = "http://demo.org"; 

XNamespace 类 内 部 有 实现 隐 式 转换 ,因此 直接 可 以 将 字符 串 实 例 赋 给 XNamespace 
类 型 的 变量 。 

步骤 3: 实例 化 三 个 XML 元 素 , 均 使 用 以 上 定义 的 ns 变量 为 XML 文档 的 命名 空间 。 


XElenent nl = new XElement(ns + "Group", 
new XElement(ns + "Name", "Jack"), 
new XElement(ns + "Level", 3)); 


XElenent n2 = new XElement(ns + "Group", 
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new XElement (ns + "Name", "Tom"), 
new XElement(ns + "Level", 2)); 
XElenent n3 = new XElement(ns + "Group", 
new XElement (ns + "Nane", "Jinm"), 
new XElement(ns + "Level", 7)); 


步骤 4: 再 声明 一 个 XML 元 素 ,将 上 述 三 个 元 素 都 包装 起 来 。 
XElenment root = new XElement(ns + "Groups", nl, n2, n3); 

步骤 5: 输出 刚 生成 的 XML 内 容 。 

Console. WriteLine( root); 


步骤 6: 运行 应 用 程序 实例 ,控制 台 输 出 结果 如 图 7-17 所 示 。 


Cprogram Files\dotn.. — 


x 


Group 
¢/Groups: 


图 7-17 带 命名 空间 的 XML 元 素 


实例 235 ”添加 命名 空间 前 绷 


【导语 】 

-个 XML 文档 中 所 使 用 的 元 素 可 能 会 来 自 于 不 同 的 命名 空间 ,为 了 能 够 区 分 来 自 不 
同 命名 空间 的 元 素 ,或 者 来 自 不 同 命名 空间 的 同名 元 素 ,需要 为 命名 空间 添加 一 个 前 级 ,这 
个 前 缀 类似 于 命名 空间 的 别名 ,在 同一 个 文档 中 不 会 重复 出 现 。 

XML 命名 空间 的 前 级 是 通过 XAttribute 类 将 其 作为 元 素 特性 添加 到 文档 中 的 , 形 如 : 


xmlns:abc = "http. temp.orp" 
这 里 "abc” 为 命名 空间 的 前 组 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 定义 两 个 备用 的 XML 命名 空间 。 


XNamespace nsl = "demol.org"; 
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XNamespace ns2 = "demo2.org"; 
步骤 3: 声明 两 个 XAttribute 实例 ,为 以 上 两 个 命名 空间 添加 前 级。 


XAttribute profileAtt1 = new XAttribute(XNamespace. Xmlns + "na", ns1); 
XAttribute profileAtt2 = new XAttribute(XNamespace. Xmlns + "nb", ns2); 


特性 中 的 “xmlns” 字 段 可 以 通过 访问 XNamespace 类 的 Xmlns 静态 属性 直接 获取 , 随 


后 紧 跟 的 是 命名 空间 前 级 的 名 称 ,此 处 分 别 命名 为 “na” 和 “nb”。 
步骤 4: 创建 XML 元 素 及 其 子 元 素 。 


XElement xml = new XElement(nsl + "Root"，profileRhtt1，profileRtt2， 
new XElement(nsl + "Layoutl", "Border"), 
new XElement(ns2 + "Layout2", "Canvas")); 


将 上 述 定义 的 用 于 指定 命名 空间 别名 的 两 个 特性 分 别 应 用 到 Root 元 素 上 。 子 元 素 会 
继承 特性 中 指定 的 别名 ,因此 Root 的 子 元 素 无 须 再 添加 xmlns 特性 。 
步骤 5: 生成 的 XML 文档 如 下 。 


< na:Root xmlns:na = "denol.org" xmlns:nb = "denmo2.org"> 
< na:Layoutl > Border </na:Layout1l > 
< nb:Layout2 > Canvas </nb:Layout2 > 

</na:Root > 


Root、Layoutl 元 素 都 来 自 demol. org 命名 空间 ,Layout2 来 自 demo2. org 命名 空间 。 
7.3 动态 类 型 


实例 236 ”通过 ExpandoObject 类 创建 动态 实例 


【导语 】 

需要 使 用 dynamic 关键 字 来 声明 动态 类 型 ,并 且 在 编译 阶段 动态 对 象 不 会 进行 解析 ,而 
是 在 运行 阶段 进行 解析 ,因此 在 代码 编辑 器 中 输入 代码 时 ,不 会 出 现成 员 列表 的 智能 提示 。 
开发 人 员 在 访问 动态 类 型 的 成 员 时 ,一定 不 能 将 成 员 的 名 字 输 错 了 。 

ExpandoObject 是 专 为 动态 类 型 而 封装 的 类 型 ,可 以 把 该 类 型 的 新 实例 赋值 给 用 
dynamic 关键 字 声 明 的 变量 ,随后 就 可 以 作为 动态 对 象 来 访问 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 引入 以 下 命名 空间 。 


using System. Dynamic; 


步骤 3: 声明 动态 类 型 的 变量 ,再 用 ExpandoObject 的 新 实例 进行 初始 化 。 
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dynanic dx = new ExpandoObject(); 


步骤 4: 给 动态 类 型 的 成 员 赋 值 ,成 员 名 称 无 须 事先 定义 ， 


dx. Message = "Hello"; 
dx. Time = new DateTime(2009, 2, 1, 23, 54, 16); 


步骤 5; 访问 动态 类 型 的 成 员 , 并 输出 成 员 的 值 。 


叶 


会 在 运行 阶段 动态 添加 。 


Console. WriteLine( $ "Message = {dx.Message}\nTine = {dx.Time}"); 


注意 : 成 员 名 称 一 定 要 与 前 面 写 入 时 用 的 名 称 保持 一 致 。 


步骤 6: 运行 应 用 程序 ,输出 内 容 如 下 。 


Message = Hello 
Tine = 2009 一 2 一 1 23:54:16 


实例 237 以 字典 形式 访问 ExpandoObject 
【导语 】 


因为 ExpandoObject 类 显 式 实现 了 IDictionary 接口 ,所 以 能 够 作为 字典 类 型 来 访问 。 
运行 阶段 向 ExpandoObject 实例 添加 的 动态 成 员 名 称 , 会 以 字符 串 形 式 存 放 在 动态 类 型 中 。 
如 果 以 字典 形式 访问 ExpandoObject 对 象 ,需要 将 它 将 转换 为 IDictionary 接口 .再 通 


过 该 接口 去 读 取 里 面 的 数据 。 
【操作 流程 】 
步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 引入 以 下 命名 空间 。 


using System. Dynamic; 
using System. Collections. Generic; 


步骤 3: 声明 动态 类 型 变量 ,并 初始 化 其 成 员 。 


dynanic d = new ExpandoObject(); 
d. AppName = "Sample"; 

d.Ver = "1.0.3"; 

d.Desc = "test application"; 
d.Release = 5; 


步骤 4: 使 用 IDictionary 接口 引用 动态 类 型 实例 。 


IDictionary < string, object> dic = di; 


步骤 5: 使 用 foreach 循环 读 出 字典 中 的 Key 和 Value 的 值 。 


foreach(var i in dic) 


{ 
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Console. WriteLine( $ "{i. Key} : {i.Value}"); 


} 
步骤 6: 运行 应 用 程序 ， 


AppName : Sanple 
Yee :1.0.3 
Desc : test application 
Release : 5 


输出 内 容 如 下 。 


实例 238” 自 定义 的 动态 类 型 


【导语 】 
尽管 框架 提供 了 默认 的 
用 ,但 是 有 时 候 在 开发 过 程 中 


动态 类 型 处 理 方案 ,也 封装 了 ExpandoObject 类 供 开 发 人 员 使 
P 会 有 特殊 需求 ,这 种 情况 下 框架 所 提供 的 方案 也 许 不 能 解决 现 


有 问题 ,开发 人 员 可 以 考虑 编写 自 定义 的 动态 类 型 , 


编写 自 定义 动态 类 型 的 


整体 思路 : 从 DynamicObiect 类 派生 出 自己 的 类 型 ,然后 根据 


需要 有 选择 地 重 写 DynamicObject 类 的 虚 方 法 (在 声明 时 虚 方 法 使 用 virtual 关键 字 ) 。 
- 般 情 况 下 ,开发 人 员 需 要 重点 重 写 以 下 两 个 虚 方 法 。 
(1) TrySetMember: 该 方法 类 似 于 为 公共 属性 或 字段 赋值 ,调用 格式 为 obj. Property 


= 105。 


(2) TryGetMember: 类 似 于 访问 字段 或 属性 ,主要 是 读 取 内 容 , 形 如 a = obi. 


Property。 


另外 ,可 能 需要 重 写 以 下 几 个 方法 。 


(3) TryInvoke Member 


: 类 似 于 方法 调用 , 形 如 obj. Add( … ) 。 


(4) TryInvoke: 模拟 委托 对 象 的 调用 形式 , 形 如 obj(… )。 
(5) TryBinaryOperation: 模拟 运算 符 ,例如 按 位 “与 ”加 减法 等 运算 。 
(6) TryGetIndex 和 TrySetIndex: 类 似 于 索引 器 。 


本 实例 将 自 定义 一 个 动 


态 类 型 , 重 写 TryGetMember 和 TrySetMember 方法 ,实现 get 


和 set 访问 器 ,该 动态 类 型 内 部 使 用 字典 集合 来 存放 数据 。 


【操作 流程 】 


步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 类 ,从 DynamicObject 类 派生 。 


public class CustonDYnani 
{ 


cObject : DynamicObject 
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步骤 3: 重 写 TryGetMember 方法 ,完成 get 访问 器 。 


public override bool TryGetMember (GetMemberBinder binder, out object result) 
. 
return _data. TryGetValue(binder. Name. ToLower(), out result); 


} 
binder 参数 中 包含 访问 动态 类 型 时 传递 的 调用 数据 ,例如 成 员 名 字 ,返回 值 类 型 等 。 
步骤 4: 重 写 TrySetMember 方法 ,实现 set 访问 器 。 


public override bool TrySetMember(SetMenberBinder binder, object value) 


{ 
return _data. TryAdd(binder. Nane. ToLower(), value); 


村 


步骤 5: 在 Main 方法 中 使 用 上 述 自 定义 动态 类 型 。 声 明 变 量 时 需要 使 用 dynamic 关 
键 宇 , 然 后 用 自 定 义 动 态 类 型 的 新 实例 为 变量 赋值 。 


dynamic dv = new CustomDynamicObject(); 
步骤 6: 为 动态 对 象 赋值 。 


dv. ItemR = 30000; 
dv. ItemB = (uint)500000; 
dv. ItemC 人生 


注意 ; 动态 类 型 的 成 员 名 称 将 在 运行 阶段 解析 ,因此 在 输入 代码 时 不 会 有 智能 提示 。 


步骤 7: 输出 动态 类 型 各 成 员 的 值 ,以 及 成 员 值 的 数据 类 型 。 


Console. WriteLine( $ "ItemA : {dv. ItemA}, {dv.ItenmA.GetType()}"); 
Console. WriteLine( $ "ItemB : {dv. ItemB}, {dv.ItenB.GetType()}"); 
Console. WriteLine( $ "ItemC : {dv. ItemC}, {dv.ItenC.GetType()}"); 


步骤 8: 运行 应 用 程序 ,控制 台 的 输出 文本 如 图 7-18 所 示 。 


7-18 输出 自 定义 动态 类 型 的 成 员 


实例 239 在 自 定义 动态 类 型 中 直接 定义 成 员 


【导语 】 
在 从 DynamicObject 类 派生 时 ,可 以 通过 重 写 TryGetMember、TrySetMember 等 方法 


第 7 章 LINO 与 动态 类 型 | 其 289 


来 响应 调用 代码 的 成 员 访问 。 实 际 上 ,开发 者 可 以 在 自 定义 的 动态 类 型 上 直接 定义 成 员 , 如 
字段 ,属性 方法 等 。 在 应 用 程序 运行 期 间 ,会 优先 查找 并 解析 类 中 已 经 定义 的 成 员 , 如 果 调 
用 方 所 指定 的 成 员 未 在 类 中 定义 , 才 会 去 调用 TryGetMember 等 方法 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 从 DynamicObject 类 派生 出 一 个 自 定义 的 动态 类 型 。 


public class MYDynamic : DynamicObject 
{ 


private IDictionary< string, object > data = new Dictionary< string，object>(); 


// 明确 定义 的 属性 ,动态 类 型 会 直接 访问 该 属性 
public string WorkDescription { get; set; } 
public string WorkName { get; set; } 

public bool IsStarted { get; set; } 


// 其 他 未 声明 的 属性 就 通过 重 写 的 TryGetMember 和 TrySetMember 方法 访问 
public override bool TryGetMember(GetMemberBinder binder, out object result) 


Console. WriteLine( $ "\n 类 中 未 定义 的 成 员 : {binder. Name}\n"); 
return data. TryGetValue(binder. Name. ToLower(), out result); 
} 
public override bool TrySetMember(SetMemberBinder binder, object value) 
{ 
Console. WriteLine( $ "\n 类 中 未 定义 的 成 员 : {binder. Name}\n"); 
return data. TryAdd( binder. Name. ToLower( ), value); 


» 


在 上 述 类 中 ,WorkDescription、WorkName,IsStarted 是 类 型 明确 定义 的 成 员 , 在 访问 
动态 类 型 时 ,如 果 调 用 方 访问 的 成 员 名 称 与 它们 匹配 , 则 它们 会 被 优先 访问 ; 如 果 调 用 方 请 
求 访问 的 成 员 名 称 在 类 中 未 定义 , 转 而 访问 TrySetMember 方法 和 TryGetMember 方法 。 

步骤 3: 在 Main 方法 中 声明 动态 类 型 变量 ,并 用 MyDynamic 类 的 新 实例 对 其 初始 化 。 


dynanic d = new MyDynamic(); 


步骤 4: 向 动态 类 型 对 象 的 成 员 赋值 。 


d.WorkName = "冲压 工序 "， // 已 定义 成 员 
d.WorkDescription = "此 工序 需要 持续 较 长 的 时 间 "， // 已 定义 成 员 
d.IsStarted = false; // 已 定义 成 员 
d.WorkType = 15; // 未 定义 成 员 


d. StartTime = new DateTime(2018, 8, 3); // 未 定义 成 员 
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步骤 5: 在 控制 台中 输出 部 分 成 员 的 内 容 。 


Console. WriteLine( $ "Work Name : {d. WorkName}"); 
Console. WriteLine( $ "Start Time : {d. StartTime}"); 
Console. WriteLine( $ "Work Type : {d. WorkType}"); 


步骤 6: 运行 应 用 程序 ,输出 内 容 如 图 7-19 所 示 。 


CAprogramfiles\do.. — 口 x 


图 7-19 调用 带 已 定义 成 员 的 动态 类 型 


实例 240 ”模拟 委托 实例 的 调用 


【导语 】 
在 继承 DynamicObject 类 时 重 写 TryInvoke 方法 ,可 以 模拟 委托 类 型 的 调用 方式 。 方 
法 原型 如 下 : 


bool TryInvoke( InvokeBinder binder, object[] args, out object result); 


其 中 ,args 参数 表示 在 调用 时 传递 进来 的 参数 列表 ,result 参数 表示 调用 结果 。 

本 实例 将 通过 重 写 TryInvoke 方法 来 模拟 委托 实例 的 调用 ,并 且 将 传递 的 参数 进行 累 
加 ,最 后 输出 计算 结果 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 从 DynamicObject 类 派生 一 个 自 定义 类 ,并重 写 TryInvoke 方法。 


public class MyCustDynanic : DynamicObject 
4 
public override bool TryInvoke( InvokeBinder binder, object[ ] args, out object result) 
{ 
result = 0; 


int temp = 0; 
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foreach( int n in args.Cast < int >()) 
{ 
temp += n; 
} 
result = temp; 


return true; 


} 
步骤 3: 在 Main 方法 中 以 动态 类 型 方式 实例 化 MyCustDynamic 类 。 


dynanic d = new MYCustDynanic() 

步骤 4: 模拟 委托 实例 调用 ,并 接收 调用 结果 。 
intr = d(2, 10, 15, 7); 

步骤 5: 运行 应 用 程序 ,得 到 的 计算 结果 如 下 。 
计算 结果 : 34 


第 二 篇 技术 进 阶 


掌握 上 一 篇 章 中 的 基础 知识 后 ,读者 将 在 本 篇 中 学 习 到 以 下 常用 
的 技术 模块 。 


文件 与 目录 的 常用 操作 (如 创建 与 删除 文件 ); 

流 (Stream) 对 象 的 运用 (内 存 流 、 文 件 流 等 ); 
序列 化 与 反 序列 化 ; 

多 线程 与 异步 编程 ; 

数据 的 加 密 与 解密 ; 

网 络 通信 技术 的 应 用 (Socket 编程 .HTTP 交互 ); 

反射 (在 运行 时 获取 类 型 信息 ,动态 调用 类 型 或 类 型 成 员 )。 


文件 与 IO 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。 目 录 与 文件 ; 

， 流 ; 

压缩 与 解压 缩 ， 

。 内存 映射 文件 ; 


。 命名 管道 。 
8.1 目录 与 文件 


实例 241 创建 目录 与 文件 

【导语 】 

本 实例 将 演示 Directory 类 和 File 类 的 使 用 方法 。Directory 类 公开 了 一 系列 静态 方 
法 ,可 以 很 方便 地 操作 目录 ,例如 创建 目录 ,删除 目录 等 。File 类 的 功能 与 Directory 类 相 
似 , 它 也 公开 了 一 系列 静态 方法 ,以 便 对 文件 进行 操作 ,例如 创建 文件 .向 文件 写 人 数据 、 删 
除 文件 等 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 在 当前 应 用 所 在 的 目录 下 新 建 子 目录 ,命名 为 test_dir。 

Directory. CreateDirectory("test_dir"); 

步骤 3: 在 test_dir 目录 下 创建 一 个 新 文件 ,命名 为 sample. data。 

var stream = File.Create("test_dir/sample. data"); 

调用 Create 方法 后 ,返回 一 个 FileStream 实例 ,随后 可 以 通过 该 对 象 向 文件 写 人 内 容 。 

步骤 4: 向 新 文件 中 写 人 5 字 节 。 


byte[ ] buffer = {5, 7, 9, 11, 13 } 
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stream. Write(buffer, 0, buffer.Length); 
stream. Close( ); 
stream. Dispose( ); 


FileStream 实例 是 流 对 象 ,使 用 完 之 后 必须 释放 ,各 免 应 用 程序 长 时 间 占 用 文件 资源 。 
实例 242 ”修改 文件 的 创建 时 间 


【导语 】 

File 类 公开 了 一 对 可 以 操作 文件 的 创建 时 间 的 静态 方法 : GetCreationTime 方法 返回 
指定 文件 的 创建 时 间 , SetCreationTime 方法 则 用 于 修改 文件 的 创建 时 间 。 与 创建 时 间 相 
似 , 可 以 通过 GetLastAccessTime 和 SetLastAccessTime 方法 来 读 写 文件 的 最 后 访问 时 间 ， 
也 可 以 通过 GetLastWriteTime 和 SetLastWriteTime 方法 来 读 写 文件 的 最 后 写 人 时 间 。 

本 实例 首先 创建 文件 ,然后 修改 文件 的 创建 时 间 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 创建 新 文件 。 


string file name = "testFile"; 
// 创建 文件 
using(var s = File.Create(file nane)) 
{ 
s. WriteByte(100); 
s. WriteByte(200); 
} 


步骤 3: 输出 文件 的 创建 时 间 。 
Console. WriteLine( $ "文件 {file_name} 的 创建 时 间 :{File. GetCreationTime(file_name)}"); 


步骤 4: 修改 文件 的 创建 时 间 。 


DateTime creationTine = new DateTime(2016, 8, 16, 23, 14, 50); 
File.SetCreationTime(file_name, creationTime); 


步骤 5: 青 次 输出 文件 的 创建 时 间 。 


Console. WriteLine( $ "修改 后 ,文件 {file_name} 的 创建 时 间 为 : {File. GetCreationTime (file_ 
name)}"); 


步骤 6: 运行 应 用 程序 ,输出 结果 如 图 8-1 所 示 。 


图 8-1 修改 前 后 的 创建 时 间 
步骤 7: 打开 所 创建 文件 的 “属性 ”窗口 ,可 以 看 到 修改 后 的 创建 时 间 , 如 图 8-2 所 示 。 
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创建 时 间 : 2016 年 8 月 16 昌 ,23:14:50 

修改 时 间 : 2018 年 ?月 23 日 ，16.50:40 

访问 时 间 : 2018 年 7 月 23 日 ，1639:55 
图 8-2 系统 显示 文件 的 创建 时 间 


实例 243 ”使 用 FileInfo 类 来 创建 文件 


【导语 】 

File 类 提供 的 静态 方法 使 用 简便 , 除 File 类 公开 的 方法 外 ,开发 人 员 也 可 以 使 用 
FileInfo 类 来 创建 文件 。 与 File 不 同 , 在 使 用 FileInfo 前 需要 进行 实例 化 ,传递 给 构造 函数 
的 参数 为 要 处 理 的 文件 名 (相对 路 径 或 绝对 路 径 ) 。 实 例 化 FileInfo 对 象 后 ,可 以 调用 实例 
方法 Create 来 创建 新 文件 ,该 方法 调用 后 返回 一 个 文件 流 实例 (FileStream) ,可 用 于 向 文件 
写 入 内 容 。 类 似 地 ,对 于 DirectoryInfo 类 ,也 可 以 先进 行 实例 化 ,然后 调用 Create 方法 来 创 
建 目录 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 应 用 程序 项 目 。 

步骤 2: 创建 FileInfo 实例 。 


FileInfo file = new FileInfo("test data"); 
步骤 3: 调用 Create 方法 创建 新 文件 ,并 向 该 文件 写 人 数据 。 


using(var s = file.Create()) 
{ 
s. Write(new byte[] { 55, 13, 27, 4, 16 }); 
} 
步骤 4: 运行 示例 程序 后 ,在 应 用 程序 所 在 目录 会 生成 一 个 test_data 文件 ,可 以 通过 系 
统 的 “属性 ”窗口 查看 刚 新 建 的 文件 ,如 图 8-3 所 示 。 


实例 244 ”判断 目录 是 否 已 经 存在 


【导语 】 

要 分 析 指 定 的 目录 是 否 存 在 ,有 两 种 方法 : 

(1) 直接 调用 Directory 类 的 Exists 方法 ,并 将 待 分 析 目 录 的 完整 路 径 传 递 给 方法 ,如 
果 目 录 已 经 存在 ,Exists 方法 返回 true, 和 否则 返回 false。 

(2) 先 用 待 分 析 目 录 的 路 径 创 建 一 个 DirectoryInfo 实例 ,再 通过 其 Exists 属性 来 判断 
目录 是 否 存 在 。 

对 应 地 ,如 果 要 判断 一 个 文件 是 否 存 在 ,可 以 调用 File 类 的 Exists 方法 ,或 者 使 用 
FileInfo 类 的 Exists 属性 。 
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宙 规 。 安全 详细 信息 以 前 的 版 本 


图 test data 


文件 类 型 : 文件 

描述 : test data 

位 置 : :e\repos\Demo\Demo\bin\Debug\netcoreapp2.1 
大 小 : 5 字 节 65 字 二 


点 用 空间 : 0 字 节 


创建 时 间 : 2018 年 7 月 23 日 ，17:11:03 
修改 时 间 :。 2018 年 7 月 23 日 ，17:11:03 


访问 时 间 : 2018 年 7 月 23 日 ，17:11:03 


层 性 : [| 高 级 (Di- 


C= |] ™ | 


图 8-3 查看 文件 属性 


【操作 流程 
步骤 1: 新 建 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 一 个 字符 串 类 型 的 变量 .表示 目录 的 名 称 。 


string dirName = "sample folder"; 
步骤 3: 当 目 录 不 存在 的 情况 下 ,创建 该 目录 。 


证 (!Directory. Exists(dirName)) 


{ 


Directory. CreateDirectory(dirName); 


} 

如 果 目 录 已 经 存在 ,那么 就 不 会 去 创建 目录 了 。 

实例 245 ”向 文件 追加 文本 

【导语 】 

以 “Append” 开 头 的 方法 ,都 是 用 于 向 文件 追加 内 容 的 ,其 特点 是 : 如 果 文件 不 存在 ,将 
创建 新 文件 ,并 写 和 内容 , 如 果 文 件 已 经 存在 且 文 件 中 已 有 内 容 ,就 从 文件 的 末尾 开始 写 
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入 , 即 文件 原 有 的 内 容 不 会 被 删除 。 

File 类 公开 了 以 下 几 种 追加 方法 。 

(1) AppendAllLines: 写 人 的 内 容 以 行为 单位 ,内 容 中 的 每 个 元 素 单独 写 和 一行 ,元 素 
后 面 自动 追加 换行 符 。 

(2) AppendAllText: 以 文件 末尾 为 写 入 点 ,一 次 性 将 内 容 写 入 文件 ,内 容 结 尾 不 会 自 
动 添 加 换行 符 。 

(3) AppendText: 此 方法 最 为 灵活 。 它 返回 一 个 StreamWititer, 支持 向 文件 写 入 各 种 
数据 类 型 的 内 容 , 如 char、int 等 。 

本 实例 将 演示 AppendAlIText 方法 的 使 用 ,将 四 句 唐诗 写 人 文本 文件 ,其 中 第 二 次 写 
入 的 文本 中 带 有 换行 符 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 字符 串 变 量 ,存放 文件 名 。 


string file name = "abc.txt" 
步骤 3: 依次 向 文件 追加 四 句 唐诗 。 


File. AppendAllText(file_nanme, "绝对 有 佳人 ,"); 

File. AppendAllText(file_name, "项 居 在 空谷 。\r\n"); 

File. AppendAllText(file_name, " 自 云 良家 子 ,"); 

File. AppendAllText(file_nane, "零落 依 草木 。"); 

步骤 4: 按 下 F5 快捷 键 运行 程序 。 

步骤 $: 待 程序 执行 结束 后 ,打开 项 目的 \bin\Debug\netcoreapp < 版 本 号 > 子 目录 ,会 看 到 
有 一 个 abc. txt 文件 ,用 记事 本 打开 该 文件 ,就 能 看 到 本 实例 所 写 入 的 内 容 ,如 图 8-4 所 示 。 


制 abc.bc - 记事 本 


图 8-4 被 追加 的 内 容 


注意 : 为 了 能 在 记事 本 中 查看 文件 时 呈现 换行 效果 ,示例 中 使 用 的 换行 符 为 \r\n, 即 回 车 符 
与 换行 符 的 结合 。 
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实例 246 覆 写 文件 内 容 


【导语 】 

以 “Write” 开 头 的 方法 ,不 同 于 以 “Append” 开 头 的 方法 。Append* 方法 不 会 删除 文件 
原 有 的 内 容 , 而 Write ”方法 是 先 清除 文件 原 有 的 内 容 , 再 重新 写 人 。 

本 实例 将 演示 WriteAllText 方法 的 使 用 方法 ,三 次 写 人 文件 ,而 最 终 只 保留 最 后 一 次 
写 人 的 内 容 。 

【操作 流程 】 

步骤 1: 新建 控 制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 字符 串 变 量 , 存 放 文件 名 。 


string fileName = "abc.txt"; 


步骤 3: 调用 WriteAlIText 方法 ,分 三 次 写 人 文件 。 


划 ab< 可 本 - 口 


文件 (有 编 电 ( 昌 ， 格 t(O) 查看 (V) 帮助 (H) 
File.WriteAllText(fileName, "第 一 次 写 人 的 文本 。") 三 次 写 入 的 文本 。 


File.WriteAllText(fileName, "第 二 次 写 人 的 文本 。"); 

File.WriteAllText(fileName, "第 三 次 写 人 的 文本 。"); 

步骤 4: 运行 示例 程序 。 

步骤 5: 待 程序 执行 结束 后 ,找到 项 目 目录 下 的 \bin 
\Debug\netcoreapp > 版 本 号 > 子 目 录 , 打 开 abc. txt 文 
件 , 如 图 8-5 所 示 ,文件 中 只 保留 最 后 一 次 写 人 的 内 容 。 


实例 247 ”使 用 FileInfo 类 删除 文件 

【导语 】 

删除 文件 有 两 种 方法 : 第 一 种 方法 是 直接 调用 File 类 的 Delete 方法 ,此 方法 为 静态 方 
法 ; 第 二 种 方法 是 先 实例 化 FileInfo 类 ,然后 调用 Delete 实例 方法 删除 文件 。 

本 实例 将 通过 FileInfo 实例 来 演示 文件 的 删除 操作 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 字符 串 变 量 ,用 于 存放 文件 名 。 


图 8-5 保留 最 后 写 入 的 内 容 


string fileName = "test" 

步骤 3: 创建 FileInfo 实例 。 

FileInfo info = new FileInfo(fileName); 

步骤 4: 判断 文件 是 否 已 存在 ,如 果 存 在 ,就 调用 Delete 方法 删除 文件 。 


证 (info. Exists) 
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{ 
info. Delete( ); 
| 


步骤 5: 删除 文件 后 ,重新 创建 文件 ,并 在 文件 中 写 人 随机 生成 的 字 节 。 


using (var fs = info.Create()) 

{ 
byte[ ] buffer = new byte[512]; 
// 用 于 产生 随 字 节 
Random rand = new Random(); 
rand. NextBytes(buffer); 
fs. Write(buffer); 


} 
实例 248 ”以 行 的 形式 写 人 文本 
【导语 】 


以 行 的 形式 写 入 文本 ,会 自动 在 每 个 文本 元 素 的 后 面 加 上 换行 符 。File 类 提供 两 种 写 
入 文本 的 方法 : 一 种 是 AppendAllLines 方 法, 它 在 文件 现 有 的 内 容 上 写 入 新 文本 ; 另 一 种 
是 WriteAllLines 方法 , 它 会 将 文件 现 有 的 内 容 删 除 , 然 后 再 写 人 新 的 文本 。 

本 实例 将 演示 AppendAllLines 方法 的 用 法 , 它 在 写 入 过 程 中 不 会 删除 原 有 的 内 容 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 字符 串 变量 ,存放 文件 名 。 


string fileName = "1.txt"; 


步骤 3: 准备 要 写 入 文件 的 四 行文 本 ,也 就 是 一 个 字符 串 数组 。 


String[ ] lines = 
¥ 
"第 一 行文 本 "， 
"第 二 行文 本 "， 
"第 三 行文 本 "， 
"第 四 行文 本 " 
}; 


待 写 人 的 文本 中 不 要 求 带 有 换行 符 , 因 为 AppendAllLines 方法 会 自动 在 字符 串 后 面 加 
上 换行 符 。 
步骤 4: 调用 AppendAllLines 方法 ,将 上 述 字 符 串 数组 中 的 文本 写 入 目标 文件 。 


File. AppendAllLines(fileNane, lines); 


步骤 5: 按 快捷 键 F5 运行 应 用 程序 。 
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步骤 6: 待 程序 执行 完成 之 后 ,找到 项 目 目录 下 的 \bin\Debug\netcoreapp < 版 本 号 > 子 
目录 ,打开 1. txt 文件 ,就 可 以 看 到 写 入 的 四 行文 本 了 ,如 图 8-6 所 示 。 


文件 (F) 编辑 (E) 格式 (0) 查看 (V) 帮助 (H) 
第 一 行文 本 


图 8-6 已 写 入 四 行文 本 


实例 249 重 命 名 目录 


【导语 】 

车 需要 重 命名 目录 ,可 以 使 用 Move 方法 。Move 方法 的 主要 功能 是 移动 文件 或 目录 ， 
但 也 可 以 用 于 实现 文件 或 目录 的 重 命 名 ,原理 是 将 原来 的 文件 或 目录 移动 到 相同 的 位 置 ,但 
在 移动 的 目标 位 置 使 用 新 的 名 字 。 

本 实例 演示 了 使 用 Move 方法 来 重 命名 目录 ,文件 的 重 命名 方法 类 似 。 

【操作 流程 】 

步骤 1: 创建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 两 个 字符 串 变量 ,分 别 表 示 重 命名 前 后 的 目录 名 称 。 


String oldName = "test 1"; 
string newName = "test 2"; 


步骤 3: 用 oldName 作为 目录 名 称 创建 一 个 新 目录 。 
Directory. CreateDirectory(oldName); 


步骤 4: 调用 Move 方法 移动 创建 好 的 目录 ,目标 为 新 的 目录 名 称 , 即 newName 变量 所 
指定 的 名 称 。 


Directory. Move(oldName, newName); 


步骤 5: 运行 应 用 程序 。 
步骤 6: 待 程序 执行 完成 后 ,在 项 目 所 在 的 目录 下 找到 \bin\Debug\netcoreapp < 版 本 号 > 
子 目录 ,可 以 看 到 名 为 test_2 的 目录 。 


注意 : 考虑 到 各 个 平台 中 文件 系统 的 差异 ,一般 建议 跨 平 台 应 用 程序 使 用 相对 路 径 ,增强 应 
用 程序 的 通用 性 。 
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实例 250 ”通过 ReadAllLines 方法 读 取 文 件 中 的 所 有 行 


【导语 】 

ReadAllLines 方法 一 般 用 于 读 取 文本 文件 , 它 可 以 将 文件 中 的 所 有 文本 行 读 出 来 ,并 
将 每 一 行 作为 一 个 元 素 存 入 string 数组 中 ,被 读 出 的 每 一 行 字 符 都 会 自动 去 掉 换行 符 。 

【操作 流程 】 

步骤 1: 新建 控 制 台 应 用 程序 项 目 。 

步骤 2: 在 应 用 程序 项 目 所 在 目录 下 找到 \bin\Debug\netcoreapp < 版 本 号 > 子 目 录 ,在 
该 子 目 录 下 新 建 一 个 文件 ,并 使 用 文本 编辑 工具 往 文 件 中 输入 几 行文 本 ,例如 在 Windows 
平台 上 ,可 以 使 用 记事 本 来 输入 内 容 并 保存 。 

保存 文件 时 注意 选择 文件 的 编码 为 UTF-8( 如 图 8-7 所 示 ) ,这 样 应 用 程序 在 读 取 文本 
时 不 会 读 出 乱码 。 


文件 名 (N): ltest.txt 
保存 类 型 (T): | 文本 文档 ("bet) 


和 隐藏 文件 夹 编码 (E): |UTF-8 保存 (5) 
ANSI 
Unicode 


Unicode endian 
图 8-7 文本 文件 以 UTF-8 编码 保存 


步骤 3: 回 到 Visual Studio 开发 环境 ,在 Main 方法 中 声明 一 个 字符 串 变量 ,用 于 存放 
待 访问 的 文件 名 , 即 刚才 所 保存 的 文本 文件 的 名 字 。 


string fileName = "test. txt"; 


步骤 4: 读 出 文件 中 的 所 有 行 。 


CNprogr。 — 口 x 
string[ ] lines = File.ReadAllLines(fileName); 从 文件 中 读 到 的 所 有 行 


昌 李 


步骤 5: 输出 读 取 的 各 行 字符 。 


foreach (string line in lines) 


{ 


y Console. WriteLine( line); 图 8-8 从 文件 中 读 出 的 文本 行 


步骤 6: 运行 应 用 程序 , 读 出 的 文本 如 图 8-8 所 示 。 
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实例 251 依据 文件 的 大 小 排序 


【导语 】 

本 实例 整合 了 文件 操作 与 LINQ 查询 相关 的 知识 点 。 

访问 FileInfo 类 的 实例 属性 Length, 可 以 以 字 节 为 单位 获取 当前 文件 的 大 小 。 在 
LINQ 语句 中 ,可 以 使 用 orderby 子 句 并 以 Length 属性 为 依据 进行 排序 ,最 后 以 二 元 组 的 
形式 返回 查询 结果 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Program 类 中 编写 一 个 名 为 MakeFiles 的 静态 方法 ,该 方法 的 作用 是 产生 
20 个 随机 大 小 的 文件 , 稍 后 可 用 于 测试 。 


static void MakeFiles() 
{ 
Randon rand = new Random(); 
for(int x = 0; x< 20; x++) 
{ 
// 随机 产生 字 节 数 
int bufferLen = rand.Next(10, 99999); 
// 创建 字 节 数组 
byte[ ] buffer = new byte[bufferLen]; 
// 用 随机 字 节 填充 数组 
rand. NextBytes(buffer); 
// 创建 新 文件 ,并 写 人 内 容 
using(FileStream fs = File.Create("deno " + (x + 1))) 


fs. Write(buffer); 


} 

步骤 3: 在 Main 方法 中 ,调用 MakeFiles 方法 来 生成 随机 文件 。 
MakeFiles( ); 

步骤 4: 实例 化 DirectoryInfo 类 ,目标 目录 为 当前 应 用 程序 所 在 的 目录 。 
DirectoryInfo dir = new DirectoryInfo("./"); 

步骤 5: 使 用 LINQ 语句 查询 ,并 按 文 件 大 小 排序 。 


var q = fron f in dir.EnumerateFiles("demo *") 
orderby f. Length 
select (FileName: f.Name, FileSize: f.Length); 


此 处 使 用 EnumerateFiles 方法 罗列 当前 目录 下 的 子 文件 而 非 GetFiles 方法 ,因为 
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EnumerateFiles 方法 更 适用 于 查询 操作 ,此 方法 不 必 等 待 所 有 文件 扫描 完成 后 再 返回 ,从 调 
用 方法 开始 就 会 返回 找到 的 文件 ,所 以 能 提升 查询 的 效率 。 
步骤 6: 输出 查询 结果 。 


foreach (var i in q) 
{ 
Console. WriteLine( $ "文件 : {i. FileName}, 大 小 : 

{i. FileSize} 字 节 "); 

} 

步骤 7: (此 步骤 可 选 ) 打 开 项 目 属性 窗口 ,切换 到 
“生成 事件 ?选项 页 ,在 “生成 前 事件 命令 行 " 中 输入 以 
下 命令 : 


del $ (OutDir)\\demo_* 


这 样 可 以 在 重新 生成 项 目的 时 候 删 除 测试 所 用 的 
文件 。$ (OutDir) 宏 表示 应 用 项 目的 输出 目录 ,默认 
是 项 目 目 录 下 的 \bin\Debug\netcoreapp < 版 本 号 > 子 8-9” 按 大 小 排序 后 的 文件 列表 
目录 。 

步骤 8: 运行 应 用 程序 ,排序 后 的 结果 如 图 8-9 所 示 。 


实例 252” 枚 举人 磁盘 驱动 器 


【导语 】 

DriveInfo 类 封装 了 与 磁盘 驱动 器 的 有 关 的 信息 ,如 卷 标 、 可 用 空间 、 根 目录 等 。 调 用 静 
态 的 GetDrives 方法 ,可 以 获取 当前 系统 中 的 驱动 器 列表 。 在 访问 驱动 器 信息 之 前 ,应 当先 
检查 一 下 IsReady 属性 ,只 有 当 该 属性 为 true 时 ,此 驱动 器 的 信息 才 有 效 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 调用 静态 方法 GetDrives ,获取 驱动 器 列表 。 


DriveInfo[ ] drs = DriveInfo. GetDrives( ) 
步骤 3: 通过 LINQ 语句 查询 出 IsReady 属性 为 true 的 驱动 器 信息 。 


var q = fron d in drs 
where d. IsReady 
select d; 


步骤 4: 输出 驱动 器 信息 。 


foreach (var di in q) 
Console. WriteLinel $ "驱动 器 名 :{di.Namej"); 
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Console. WriteLine( $ " 卷 标 :{di. VolumeLabel}"); 
Console. WriteLine( $ "总 容量 :{di. TotalSize}"); 
Console. WriteLine( $ "当前 可 用 空间 :{di. TotalFreeSpace}"); 
Console. WriteLine( $ "驱动 器 类 型 : {di. DriveType}"); 
Console. WriteLine( $ "文件 格式 : {di. DriveFormat}"); 
Console. WriteLine( $ " 根 目 录 :{di. RootDirectory. Name}"); 
Console. Write("\n"); 

} 


步骤 5: 运行 应 用 程序 ,输出 结果 如 图 8-10 所 示 。 


CNProgram Files\dotnet\.. 一 口 x 


图 8-10 ”了 驱动 器 信息 


8.2 流 


实例 253 ”向 内 存 流 写 人 内 容 


【导语 】 

流 , 是 输入 /输出 操作 中 很 常用 的 一 种 类 型 , 它 表示 数据 内 容 的 字 节 按照 顺序 进行 排列 。 
读 写 流 中 的 字 节 时 , 既 可 以 按照 其 排列 的 顺序 来 处 理 , 也 可 以 随意 移动 读 写 的 指针 位 置 ,以 
完成 更 复杂 的 输入 /输出 操作 。 

内 存 流 , 即 从 内 存 中 划分 出 一 个 特定 区 域 ,应 用 程序 可 以 将 字 节 序列 存放 到 这 个 区 域 
中 。 内 存 流 很 适合 用 于 读 写 临时 数据 ,因为 它 不 用 处 理 磁盘 上 的 文件 ,可 以 直接 在 内 存 中 完 
成 相关 处 理 , 速 度 快 ,而 且 用 完 之 后 可 以 马上 释放 内 存 资 源 。 对 于 不 需要 长 久保 存 的 内 容 ， 
特别 适合 在 内 存 流 中 读 写 。 

MemoryStream 类 封装 了 一 系列 操作 内 存 流 的 方法 。 所 有 与 流 相 关 的 类 型 都 实现 了 
IDisposable 接口 ,以 便于 在 使 用 完 之 后 可 以 释放 其 占用 的 资源 。 比 较 优雅 的 一 种 做 法 是 : 
把 流 对 象 的 实例 放 在 using 语句 块 中 ,在 执行 完 using 语句 块 后 会 自动 释放 实例 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
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步骤 2: 声明 一 个 字 节 数组 ,并 进行 赋值 。 
byte[] buffer = {155, 16, 3, 200, 77, 9, 21, 34, 60 }; 
步骤 3: 在 using 代码 块 中 创建 MemoryStream 实例 。 


using(MemoryStream stream = new MemoryStream()) 


{ 


} 
步骤 4: 将 刚才 创建 的 字 节 数组 写 人 到 内 存 流 中 。 


using(MenoryStream stream = new MemoryStream() ) 
{ 
// 写 人 内 容 


stream. Write(buffer) 


注意 : 在 Stream 类 中 ,接受 byte[ ] 类 型 参数 的 Write 方法 声明 如 下 。 
void Write(byte[ ] buffer, int offset, int count); 
而 本 实例 中 实际 使 用 的 为 如 下 重 载 版 本 。 
void Write(ReadOnlySpan < byte> buffer); 
该 方法 接受 的 参数 类 型 是 ReadOnlySpan< byte>, 之 所 以 可 以 直接 把 byte[] 类 型 的 
实例 传递 给 buffer 参数 ,是 因为 ReadOnlySpan 结构 定义 了 隐 式 转换 ,数组 类 型 实例 
可 以 直接 赋值 给 ReadOnlySpan 类 型 的 变量 , 隐 式 转换 的 声明 如 下 。 


static implicit operator ReadOonlySpan <T>(T[ ] array); 


实例 254 将 内 存 流 中 的 内 容 转换 为 字 节 数组 

【导语 】 

MemoryStream 类 公开 了 ToArray 方法 ,能 够 将 内 存 流 中 所 包含 的 内 容 转 换 为 字 节 
数组 。 

【操作 流程 ] 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 字 节 数组 变量 , 稍 后 用 于 接收 从 内 存 流 中 转换 的 内 容 。 


byte[ ] data = null; 


步骤 3: 创建 内 存 流 实例 ,并 向 其 中 写 入 20 个 随机 生成 的 字 节 。 


using (MemoryStream stream = new MemoryStream()) 
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// 用 于 产生 随机 字 节 

Random rand = new Random(); 
// 写 人 20 字 节 

byte[ ] buffer = new byte[20]; 
rand. NextBytes(buffer); 
stream. Write(buffer); 


步骤 4: 随后 调用 内 存 流 实例 的 ToArray 方法 ,获取 字 节 数组 。 


using (MemoryStream stream = new MemoryStream( ) ) 


{ 


// 从 流 中 重新 提取 字 节 数组 
data = stream.ToArray(); 
} 


步骤 5: 在 控制 台中 输出 从 内 存 流 中 提取 的 字 节 序列 。 
Console. WriteLine(BitConverter. Tostring(data)); 


步骤 6: 运行 应 用 程序 ,得 到 的 结果 如 图 8-11 所 示 。 
实例 255 ”从 内 存 流 中 读 取 内 容 


【导语 】 
本 实例 演示 了 Read 方法 的 使 用 , 它 的 声明 如 下 : 


int Read(byte[ ] buffer, int offset, int count); 


CAProgra — 口 x 


图 8-11 从 内 存 流 中 提 
取 的 字 节 序列 


buffer 参数 是 一 个 字 节 数组 ,用 来 存放 读 出 来 的 字 节 。offset 参数 指定 数组 中 开始 存 入 读 
出 字 节 的 位 置 索引 , 即 从 buffer 数组 的 哪个 位 置 开 始 写 入 读 到 的 数据 ,此 索引 是 从 0 开始 计 
算 的 。count 参数 指定 要 从 流 中 读 入 的 字 节 的 最 大 数量 。Read 方法 的 返回 值 表示 实际 读 取 


的 字 节 数量 ,如 果 流 中 剩余 的 字 节 小 于 count 参数 指定 的 数量 , 则 


Read 方法 所 返回 的 数量 


会 小 于 count 参数 所 指定 的 数量 ; 如 果 已 经 到 了 流 的 末尾 ,无 可 用 字 节 , 则 Read 方法 返 


回 0。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Program 类 中 定义 一 个 GetStream 方法 ,用 于 创 寻 
入 字 节 序列 。 


static MemoryStream GetStream( ) 
{ 


MemoryStream ms = new MemoryStream(); 


E 内 存 流 实例 并 向 流 中 写 


// 写 人 5 字 节 

ms. WriteByte(1); 
ms. WriteByte(2); 
ms. WriteByte(3); 
ms. WriteByte(4); 
ms. WriteByte(5); 
// 将 读 写 指针 复位 
ms. Position = 0L; 
return ms; 


} 
步骤 3: 在 Main 方法 中 ,调用 GetStream 方法 获取 流 实例 的 引 


using(MemoryStream stream = GetStream()) 


E 


} 
步骤 4: 从 流 中 读 取 刚刚 写 入 的 字 节 序列 。 


using(MemoryStream stream = GetStream()) 
{ 
byte[ ] buffer = new byte[ stream. Length]; 
stream. Read( buffer, 0, buffer.Length); 
Console. WriteLine( $ " 读 出 的 字 节 :\n{BitConverter. ToString(buf: 


} 

步骤 5: 运行 应 用 程序 ,输出 结果 如 下 。 

读 出 的 字 节 : 

01 一 02-03-04-05 

实例 256 ”使 用 StreamWriter 类 将 文本 写 人 文 
【导语 】 
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用 ,并 写 入 using 语句 块 


fer)}"); 


件 


StreamWriter 类 继承 了 TextWriter 类 , 它 是 专门 为 写 人 文本 内 容 而 设计 的 。 
StreamWriter 类 支持 以 流 的 形式 将 内 容 写 入 文件 ,虽然 它 允 许 写 入 如 bool、int、 decimal、 


float .object 等 数据 类 型 的 内 容 , 但 最 终 会 以 文本 的 形式 写 和 文件 品 
的 ToString 方法 ) 。 


P (如 同调 用 了 写 和 对象 


StreamWriter 类 默认 使 用 UTF-8 编码 格式 来 写 入 文本 ,如 需 改 用 其 他 编码 格式 ,可 以 
调用 带 有 System. Text. Encoding 类 型 参数 的 构造 函数 ,例如 以 下 形式 。 


StreamWriter(System. I0. Stream, System.Text. Encoding) 


写 入 内 容 的 时 候 , 可 以 调用 Write 方法 或 者 WriteLine 方法 ,两 种 方法 功能 相近 ,只 是 
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WriteLine 方法 会 自动 在 写 入 的 内 容 后 面 妃 加 换行 符 。 

StreamWriter 类 可 以 应 用 于 各 种 类 型 的 流 ,例如 内 存 流 , 文 件 流 等 。 如 果 调 用 的 是 带 
string 类 型 参数 的 构造 函数 , 则 可 以 直接 指定 文件 名 ,StreamWriter 类 会 把 文本 内 容 直 接 输 
出 到 文件 中 。 

【操作 流程 】 

步骤 1: 新建 控 制 台 应 用 程序 项 目 。 

步骤 2: 在 项 目 模板 生成 的 Main 方法 中 ,创建 StreamWriter 实例 ,要 写 入 的 文件 名 为 


abc. txt。 


using (StreamWriter writer = new StreamWriter("abc.txt")) 


} 
步骤 3: 依次 写 和 人 以 下 数据 类 型 的 内 容 : int、decimal,string、bool、DateTime。 


using (StreamWriter writer = new StreamWriter("abc. txt")) 
{ 
writer. WriteLine( 300); 
writer. Write(0.335M); 
writer. Write("test"); 
writer. WriteLine(false); 


writer. Write(DateTime. Today); 


文件 编辑 (E) 格式 (0) 查看 V) 帮助 0) | 


’ 00 
Re 0. 335testFalse 
步骤 4: 运行 应 用 程序 。 2018-7-31 0:00:00 | 


步骤 5: 待 程序 执行 完成 后 ,找到 应 用 程序 所 在 的 
目录 ,打开 abc. txt 文件 ,能 看 到 已 写 人 该 文本 文件 的 内 “图 8-12 写 入 到 文本 文件 中 的 内 容 
容 , 如 图 8-12 所 示 。 


实例 257 使 用 StreamReader 类 读 取 文本 文件 


【导语 】 

与 StreamWriter 类 相对 应 ,框架 提供 了 一 个 StreamReader 类 ,用 于 以 文本 形式 读 取 流 
中 的 内 容 。 

常用 的 读 取 方法 如 下 。 


(1) Read 方法 : 可 以 读 取 一 个 字符 ,以 int 类 型 返回 ,可 以 转换 为 char 类 型 ; 此 方法 的 
其 他 重 载 支持 读 取 多 个 字符 ,结果 存储 在 char 数组 中 。 

(2) ReadLine 方法 : 每 次 读 取 一 行 。 

(3) ReadToEnd 方法 : 一 次 性 读 取 所 有 文本 。 

在 读 取 流 的 时 候 , 有 两 种 方法 可 以 判断 读 取 指针 是 否 已 经 到 了 流 的 末尾 (到 了 流 的 末尾 
就 无 法 读 取 有 效 的 内 容 了 ): 
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第 一 种 是 调用 Peek 方法 。 该 方法 会 提取 下 一 个 字符 ,但 不 会 执行 读 取 , 如 果 没 有 可 用 
字符 ,方法 返回 一 1, 以 此 判断 读 取 指 针 已 经 到 了 流 的 末尾 。 

第 二 种 方法 是 检查 Read 或 ReadLine 方法 的 返回 值 。 对 于 ReadLine 方法 ,如 果 返 加 
null ,说 明 没 有 可 读 取 的 内 容 了 。 对 于 Read 方法 ,如 果 读 不 到 有 效 字符 ,会 返回 一 1。 

本 实例 首先 将 四 行文 本 写 人 文件 ,随后 使 用 StreamReader 类 逐 行 读 出 文本 ,并 输出 到 
控制 台 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Program 类 中 定义 WriteSomethingToFile 方法 ,用 于 将 文本 写 入 文件 。 


static void WriteSonethingToFile() 
{ 
using(StreamWriter writer = new StreamWriter("demo. txt")) 
{ 
writer. WriteLine("first line"); 
writer. WriteLine(5000000L) 
writer. WriteLine(0.000075d) 
writer. WriteLine(6600); 


} 


步骤 3: 在 Main 方法 中 ,调用 WriteSomethingToFile 方法 写 和 文件。 
步骤 4: 调用 WriteSomethingToFile 方法 后 ,实例 化 StreamReader 类 ,从 文件 中 读 取 
内 容 ( 逐 行 读 取 ,并 向 控制 台 输 出 )。 


using(StreamReader reader = new StreanReader("deno. txt")) 
{ 

string line = null; 

while( (line = reader.ReadLine()) != null) 

{ 

Console. WriteLine( line); 

} 

} 


步骤 5: 运行 应 用 程序 ,输出 结果 如 下 。 


first line 
5000000 
7.5E~— 05 
6600 


实例 258 ”调用 Seek 方法 重新 设置 流 的 当前 位 置 


【导语 】 
在 读 写 流 中 的 内 容 时 ,在 需要 的 情况 下 可 以 修改 流 的 当前 位 置 。Seek 方法 可 以 调整 流 
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的 当前 读 写 位 置 。Seek 方法 的 第 一 个 参数 是 新 的 位 置 ,如 果 位 置 向 流 的 结尾 移动 , 则 新 的 
位 置 为 正 值 ; 反之 ,如 果 位 置 向 流 的 开头 移动 , 则 应 为 负 值 。Seek 方法 的 第 二 个 参数 是 指 
定 新 位 置 的 参考 点 ,由 SeekOrigin 枚 举 指 定 , 它 包 含 以 下 三 个 可 用 值 。 

(1) Begin: 新 位 置 以 流 的 开头 为 参考 。 

(2) Current: 新 位 置 以 流 的 当前 位 置 为 参考 。 

(3) End: 新 位 置 是 相对 于 流 的 结尾 而 设 定 的 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 创建 内 存 流 实例 ,并 将 实例 化 过 程 写 在 using 代码 块 中 。 


using(MemoryStream ms = new MenoryStream() ) 


} 
步骤 3: 向 流 中 写 入 8 字 节 。 


for(bytex = 1; x<= 8; xt+) 
{ 
ms. WriteByte(x); 
Console. Write(" Ox{0:x2}", x); 
步骤 4: 将 流 的 当前 位 置 ( 读 写 指针 ) 调 整 到 倒数 第 三 个 字 节 处 。 由 于 位 置 是 相对 于 流 
的 尾部 的 ,因此 位 置 索引 为 一 3。 


ms. Seek( — 3, SeekOrigin. End); 


步骤 5: 从 新 位 置 开 始 逐 个 字 节 读 取 , 直 到 流 的 结尾 。 


int r; 
while ((r = ms.ReadByte()) > -1) 
{ 

Console. Write(" Ox{0:x2}", r); 
} 


步骤 6: 运行 应 用 程序 ,控制 台 输 出 结果 如 图 8-13 所 示 。 


DxDB Ox07 DxD8 


图 8-13 读 出 流 中 最 后 3 字 节 


实例 2 
【导语 】 
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59 通过 Position 属性 更 改 流 的 当前 位 置 


要 设置 流 的 当前 位 置 , 除 了 使 用 Seek 方法 外 ,还 可 以 直接 设置 Position 属性 。 该 属性 
的 值 是 从 0 开始 计算 的 , 即 0 表示 流 的 开始 位 置 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 将 随机 产生 的 字 节 序列 写 入 文件 。 


using(FileStrean fs = new FileStream("demo", FileMode. OpenOrCreate)) 


{ 


Random rand = new Random(); 


byte[ 
rand. 


] data = new byte[10]; 
NextBytes(data); 


fs. Write(data); 


} 


步骤 3: 从 该 文件 中 读 出 最 后 5 字 节 。 


using(Fil 
{ 
// 对 


eStrean fs = new FileStream("demo", FileMode. Open) ) 


外 新 设 定 当前 位 置 


fs.Position = 5L; 
byte[ ] buffer = new byte[fs.Length - fs.Position]; 


// 读 入 字 节 

fs. Read(buffer, 0, buffer. Length); 

// 输出 结果 

Console. WriteLine( $ "文件 中 的 最 后 5 字 节 为 :\n{BitConverter. ToString(buffer)}"); 
} 
Position 属性 的 值 是 以 0 为 基础 的 ,从 第 6 个 字 节 开始 读 取 ,当前 位 置 应 设 定 为 5。 


步骤 4: 运行 应 用 程序 ,输出 的 结果 如 下 。 


文件 中 的 最 后 5 字 节 为 : 
17-88-25-C0-7B 


8.3 压缩 与 解压 缩 


实例 2 
【导语 】 


60 ”使 用 DeflateStream 类 压缩 文件 


在 System. IO. Compression 命名 空间 下 ,框架 已 经 封装 了 一 组 常用 的 类 ,用 于 对 流 进 
行 压 缩 和 解压 缩 ,这 些 类 的 操作 方法 与 流 相似 (毕竟 它们 都 是 从 Stream 类 派生 出 来 的 ) 。 
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本 实例 使 用 压缩 功能 类 DeflateStream, 它 采用 Deflate 压缩 标准 算法 ,属于 huffman 编 
码 的 增强 版 。 框 架 内 部 默认 通过 zlib 实现 DeflateStream 类 。 

【操作 流程 】 

步骤 1: 新 建 控 制 台 应 用 程序 项 目 。 

步骤 2: 接收 用 户 输入 ,分 别 收集 待 压缩 文 件 的 路 径 和 压缩 后 文件 的 输出 路 径 。 

Console. WriteLine(" 请 输入 待 压缩 文件 的 完整 路 径 :"); 

string inputFilePath = Console. ReadLine(); 

Console. WriteLine(" 请 输入 压缩 后 文件 的 输出 路 径 :"); 

string outputFilePath = Console. ReadLine(); 

ReadLine 方法 将 从 控制 台 读 取 用 户 输入 的 一 行文 本 ,以 用 户 按 下 Enter 来 确认 。 

步骤 3: 对 输入 文件 进行 压缩 。 

using (FileStream instream = new FileStream( inputFilePath, FileMode. Open)) 

using (FileStream outstream = new FileStream(outputFilePath, FileMode. Create)) 


using (DeflateStrean defstream = new DeflateStream(outstrean, CompressionLevel. Optimal)) 
{ 


instream. CopyTo( defstream); 
} 
在 实例 化 DeflateStream 类 时 ,需要 绑 定 一 个 基础 流 实 例 ,随后 会 将 压缩 好 的 数据 写 人 
到 这 个 流 中 ,此 处 以 输出 文件 流 为 写 入 目标 。CopyTo 方法 可 以 完成 流 与 流 之 间 简 单 的 数 
据 传 递 , 它 直接 把 输入 文件 流 中 的 所 有 字 节 序列 复制 到 目标 流 中 。 
步骤 4: 执行 完 文件 压缩 后 ,分 别 输出 两 个 文件 的 大 小 ,以 观察 压缩 效果 。 


FileInfo fl1 = new FileInfol inputFilePath)，f2 = new FileInfo(outputFilePath); 

Console. WriteLine( $ "压缩 前 文件 大 小 :{f1.Length}"); 

Console. WriteLine( $ "压缩 后 文件 大 小 :{f2. Length}"); 

步骤 5: 运行 应 用 程序 ,依次 输入 待 压缩 文件 与 压缩 后 文件 的 路 径 , 按 下 Enter 键 确认 
后 会 输出 压缩 前 后 的 文件 大 小 ,如 图 8-14 所 示 。 


图 8-14 文件 压缩 前 后 的 大 小 对 比 


注意 : 并 非 所 有 文件 都 能 产生 较 高 的 压缩 比 , 某 些 特殊 文件 在 压缩 后 反而 会 增 大 ,但 增 大 的 
幅度 较 小 。 
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实例 261 创建 Zip 压缩 文档 


【导语 】 

ZipArchive 类 支持 对 zip 压缩 文档 的 基本 管理 ,压缩 文档 中 的 每 个 文件 (实体 ) 由 
ZipArchiveEntry 类 进行 维护 。 调 用 ZipArchiveEntry 实例 的 Delete 方法 可 以 将 文件 从 zip 文档 
Pb 删 除 ; 调用 Open 方法 将 得 到 一 个 流 实例 ,可 以 对 压缩 文档 中 的 文件 实体 进行 读 写 操 作 。 

本 实例 将 完成 两 项 操作 : 首先 创建 一 个 zip 压缩 文档 ,并 向 该 文档 添加 三 个 文件 实体 ， 
每 个 实体 都 写 和 内容。 然后 将 该 压缩 文档 中 的 文件 实体 解压 出 来 ,分 别 存储 到 三 个 文本 文 
件 囊 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 string 类 型 的 变量 ,存放 文件 名 。 


下 


string zipFile = "demo.zip"; 
步骤 3: 创建 zip 压缩 文档 ,并 存 人 三 个 实体 , 详 见 代码 清单 8-1。 
代码 清单 8-1 在 新 zip 压缩 文档 中 存 入 三 个 实体 


using (FileStream outfs = File.Create(zipFile)) 
{ 
using (ZipArchive zip = new ZipArchive(outfs, ZipArchiveMode. Create) ) 
{ 
// 第 一 个 文件 
ZipArchiveEntry etl = zip.CreateEntry("docs/docl. txt"); 
using (Stream stream = etl.Open()) 


{ 
using (StreamWriter writer = new StreamWriter(stream)) 
{ 
writer. Write( "示例 文档 A"); 
} 
} 
// 第 二 个 文件 


ZipArchiveEntry et2 = zip.CreateEntry("docs/doc2. txt"); 
using (Stream stream = et2. Open()) 
{ 
using (StreamWriter writer = new StreamWriter(stream)) 
L 
writer. Write(" 示 例文 档 B"); 
} 
} 
Z/ 第 三 个 文件 
ZipArchiveEntry et3 = zip.CreateEntry("docs/doc3. txt"); 
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using (Stream stream = et3.0Open()) 
{ 


using (StreamWriter writer = new StreamWriter(stream)) 
writer. Write(" 示 例文 档 C"); 


注意 : 车 要 创建 新 的 压缩 文档 ,在 调用 ZipArchive 类 的 构造 函数 时 ,不 仅 要 提供 基础 文件 的 
流 , 还 要 将 mode 参数 指定 为 ZipArchiveMode. Create, 否 则 会 发 生 异常 。 
调用 CreateEntry 方法 时 指定 的 实体 名 称 , 允 许 使 用 相对 路 径 。 


步骤 4: 将 已 创建 的 zip 压缩 文档 中 的 三 个 实体 解压 出 来 ,并 存 到 文本 文件 中 。 详 见 代 
码 清单 8-2。 


代码 清单 8-2 解压 文档 中 的 实体 


using(FileStream instream = File.OpenRead(zipFile)) 


{ 
using(ZipArchive zip = new ZipArchive( instream)) 
{ 
foreach( ZipArchiveEntry et in zip. Entries) 
{ 
using( Stream stream = et.Open()) 
{ 
using(FileStrean fsout = File.Create(et. Name)) 
{ 
stream. CopyTo( fsout); 
} 
} 
} 
} 
} 


步骤 5: 运行 应 用 程序 。 

步骤 6: 应 用 程序 执行 完成 后 ,在 应 用 程序 所 在 的 目录 下 ,会 看 到 被 解压 出 来 的 三 个 文 
本 文件 ,如 图 8-15 所 示 。 

实例 262 ”使 用 GZipStream 类 压缩 文件 

【导语 】 

GZIP( 全 称 GNUzip) 最 早 由 Jean-loup Gailly 和 Mark Adler 开发 ,用 于 Unix 系统 的 文 
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导 doci.tt -记事 本 一 口 

文件 ”编辑 (E) 格式 (O) 查看 V) 帮助 (H) 
示例 文档 A , 
届 doczbt - 记事 本 一 口 


文件 (月 ”编辑 (E) 格式 (D) 坦 看 (V) 帮助 (H) 


示例 文档 B 


加 
文件 (有 ) ”编辑 (E) 格式 (O) 查看 V) 者 助 (H) 


示例 文档 C 加 


图 8-15 解压 后 的 三 个 文本 文件 


件 压缩 ,通常 文件 扩展 名 为 . gz, 是 非常 普遍 的 一 种 数据 压缩 格式 ,或 者 说 是 一 种 文件 格式 。 
框架 以 GZipStream 类 来 封装 GZip 算法 相关 功能 ,使 用 方法 与 DeflateStream 相同 。 

本 实例 将 提示 用 户 输入 待 压 缩 文 件 的 路 径 , 确 认 后 使 用 GZip 算法 压缩 文件 ,并 在 应 用 
所 在 目录 下 输出 名 为 demo. gz 的 文件 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 获取 用 户 输入 的 待 压缩 文件 路 径 。 


Console. WriteLine(" 请 输入 待 压缩 文件 的 路 径 :"); 
string inFilePath = Console. ReadLine(); 


步骤 3: 声明 一 个 string 类 型 的 变量 ,表示 输入 的 压缩 文件 名 。 


string outFileName = "demo.gz"; 
步骤 4: 对 输入 文件 进行 压缩 处 理 。 


using (FileStream fsIn = File.OpenRead(inFilePath)) 
using (FileStream fsOut = File.Create(outFileName)) 
{ 
using (GZipStream gz = new GZipStream(fsOut, CompressionMode. Compress)) 
{ 
fsIn. CopyTo( gz); 
} 
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步骤 5: 分 别 输出 压缩 前 后 的 文件 大 小 ,以 供 对 比 。 


EileInfo infol = new FileInfo(inFilePath) 7 

FileInfo info2 = new FileInfo(outFileName); 

Console. WriteLine ($ "压缩 前 , 文件 大 小 : { infol. 
Length}"); 

Console. WriteLine ($ "压缩 后 , 文件 大 小 : { info2. 
Length}"); 


步骤 6: 运行 应 用 程序 ,输出 内 容 如 图 8-16 所 示 。 
8.4 ”内 存 映射 文件 
实例 263” 读 写 内 存 映射 文件 


【导语 】 


图 8-16 用 GZip 算 法 压缩 文件 


内 存 映 射 文 件 .其 实 是 在 应 用 程序 内 存 空 间 中 划分 的 一 块 特 殊 内 存 , 可 以 像 操 作 磁 盘 文 


件 那 样 ,在 内 存 中 新 建文 件 ,并 写 和 或 读 取 内 容 。 
在 内 存 中 不 仅 可 以 读 写 文件 ,内 存 映射 文件 还 可 以 从 磁盘 文件 


提取 内 容 ,映射 到 内 存 


空间 中 进行 操作 。 这 对 于 大 型 文件 的 读 写 尤为 重要 ,应 用 程序 不 需要 将 整个 文件 都 加 载 到 


内 存 中 ,而 是 映射 文件 中 的 一段" 数据 ,可 以 大 大 提升 效率 。 


内 存 映 射 文件 也 可 以 用 于 在 进程 之 间 共 享 数据 。 例 如 ,A 进程 创建 了 文件 1. data 并 写 


入 数据 ,然后 B 进程 可 以 从 1. data 文件 中 读 取 刚刚 写 入 的 数据 。 


在 内 存 区 域 中 创建 的 文件 不 需要 显 式 删 除 , 当 引 用 该 内 存 的 最 后 一 个 进程 退出 时 ,内 存 


中 的 数据 就 会 被 清理 并 由 系统 回收 。 


本 实例 简单 演示 了 如 何在 内 存 中 创建 文件 ,并 在 同一 个 进程 中 写 人 和 读 取 内 容 。 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 调用 CreateNew 静态 方法 创建 新 的 内 存 文件 。 


MemoryMappedFile file = MenoryMappedFile.CreateNew("test", 200L); 
步骤 3: 向 内 存 文件 写 人 一 行文 本 。 


using (var mvstream = file.CreateViewStream()) 


{ 
using (StreamWriter writer = new StreamWriter(mvstream) ) 
{ 
writer. WriteLine(" 你 好 ,这 是 一 行文 本 ,"); 
} 


调用 CreateViewStream 方法 可 以 获得 一 个 MemoryMappedVi 
流 来 读 写 文件 。 


ewStream 实例 ,并 通过 
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步骤 4: 读 取 写 人 内存 文 件 的 文本 。 


using (MemoryMappedFile mfile = MemoryMappedFile.OpenExisting("test")) 
{ 
using (var vstream = mfile. CreateViewStream()) 
{ 
using (StreamReader reader = new StreamReader(vstream)) 
{ 
string str = reader. ReadLine(); 
Console. WriteLine( str); 


’ 


对 于 已 经 存在 的 内 存 文件 , 应 该 调用 OpenExisting 静态 方法 来 获得 
MemoryMappedFile 实例 的 引用 。 


注意 : 调用 CreateNew 方法 创建 的 MemoryMappedFile 实例 ,在 写 入 完 数据 后 ,不 要 立即 释 
放 资 源 。 由 于 本 实例 的 读 写 操作 都 是 在 同一 个 进程 中 执行 的 ,如 果 写 完 数据 后 就 释 
放 实 例 , 系 统 检 测 不 到 对 内 存 文件 的 其 他 引用 ,新 创建 的 内 存 文 件 就 会 被 回收 ,就 无 
法 读 取 之 后 的 代码 了 。 


实例 264 ”将 内 存 映射 文件 写 人 磁盘 文件 

【导语 】 

内 存 映 射 文件 是 存在 于 内 存 中 的 ,一 旦 访问 该 内 存 区 域 的 所 有 进程 都 退出 ,内 存 中 的 数 
据 就 会 被 回收 ,文件 内 容 就 丢失 了 。 因 此 有 必要 将 内 存 映 射 文件 与 磁盘 文件 关联 ,这 样 当 内 
存 中 的 数据 被 回收 时 ,会 将 这 些 数据 自动 写 人 到 磁盘 文件 中 ,可 持久 存储 。 

要 建立 内 存 文件 与 磁盘 文件 之 间 的 映射 关系 ,在 获得 MemoryMappedFile 实例 时 ,应 
该 调用 静态 的 CreateFromFile 方法 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 调用 CreateFromFile 方法 ,建立 内 存 文件 与 磁盘 文件 之 间 的 映射 关系 。 


using (MemoryMappedFile mmfile = MemoryMappedFile. CreateFromFile ( " demo. data", FileMode. 
OpenOrCreate, "demo", 100L)) 

{ 

} 

此 处 调用 的 是 以 下 重 载 版 本 的 CreateFromFile 方法 。 


MemoryMappedFile CreateFronFile( string path，FileMode mode, string mapName, long capacity); 


path 参数 指定 磁盘 上 文件 的 路 径 ,mapName 参数 指定 建立 映射 关系 后 内 存 文件 的 名 
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字 。 注 意 ,本 实例 中 需要 为 capacity 参数 明确 指定 一 个 数值 ,该 数值 为 映射 文件 的 最 大 容 
量 , 因 为 磁盘 上 的 文件 原先 并 不 存在 ,是 在 内 存 文件 中 写 和 数据 后 再 保存 到 磁盘 文件 上 的 ， 
所 以 必须 指明 capacity 参数 ,否则 会 出 现 错误 。 本 例 指 定 文件 的 大 小 为 100 字 节 ,不 论 实际 
写 信 了 多 少 宇 节 , 最 终 产生 的 磁盘 文件 的 大 小 都 是 100 字 节 。 

步骤 3: 依次 写 信 int,float、long、double 四 个 数值 。 


using(var vstream = mmfile,CreateViewStreanm()) 
# 
using(BinaryWriter writer = new BinaryWriter(vstream) ) 
writer. Write(160); 
writer. Write(1.27f); 
writer. Write(900000L); 
writer. Write(13.165d); 


} 
对 于 值 类 型 的 数据 ,使 用 BinaryWriter 类 来 写 入 比较 合适 ,因为 此 类 是 以 二 进 制 方式 
来 处 理 数 据 的 。 


步骤 4: 从 生成 的 磁盘 文件 中 ,依次 读 出 这 四 个 数值 。 


using(FileStrean stream = File.OpenRead("demo. data")) 
{ 
Console. WriteLine( $ "文件 的 大 小 为 :{stream. Length}"); 
using(BinaryReader reader = new BinaryReader( stream) ) 
{ 
int vl = reader.ReadInt32(); 
float v2 = reader.ReadSingle(); 
long v3 = reader. ReadInt64(); 
double v4 = reader. ReadDouble(); 
Console. WriteLine( $ " 读 到 的 int 值 :{v1}"); 
Console. WriteLine( $ " 读 到 的 float 值 :{v2}"); 
Console. WriteLine( $ " 读 到 的 long 值 :{v3}"); 
Console. WriteLine( $ " 读 到 的 double 值 :{v4}"); 


注意 : 读 取 的 顺序 一 定 要 与 写 入 的 顺序 相同 ,才能 读 到 正确 的 值 。 


步骤 5: 运行 应 用 程序 ,控制 台 输出 结果 如 图 8-17 所 示 。 


CiProgram., 下 ” 光 
的 六 / 


8-17 ”从 磁盘 文件 中 读 出 数据 
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8.5 命名 管道 


实例 265 ”实现 本 地 进程 之 间 的 通信 

【导语 】 

命名 管道 是 一 种 比较 简单 易 用 的 通信 方式 , 它 支持 同一 台 计 算 机 上 进程 与 进程 之 间 ,或 
者 不 同 计算 机 上 进程 与 进程 之 间 的 数据 传输 。 要 使 用 命名 管道 进行 进程 间 的 通信 ,需要 用 
到 System. 10O. Pipes 命名 空间 中 的 以 下 两 个 类 . 

(1) NamedPipeServerStream 类 : 通信 中 的 服务 器 ,实例 化 该 类 型 之 后 ,需要 调用 
WaitForConnection 方法 或 者 WaitForConnectionAsync 方法 来 侦 听 客户 端 连接 。 

(2) NamedPipeClientStream 类 , 通信 中 的 客户 端 ,实例 化 该 类 型 后 ,调用 Connect 方 
法 可 以 向 服务 器 发 起 连接 请 求 。 

NamedPipeServerStream 类 与 NamedPipeClientStream 类 都 是 Stream 的 派生 类 ,因此 
它们 都 可 以 以 流 的 方式 发 送 或 接收 数据 。 

本 实例 的 解决 方案 中 包含 两 个 应 用 程序 项 目 ,分 别 表示 通信 中 的 两 个 进程 。 当 两 个 应 
用 程序 启动 后 ,用 户 可 以 在 客户 端 通过 键盘 输入 消息 然后 发 送 ,服务 器 会 显示 接收 到 的 
消息 。 

【操作 流程 】 

首先 实现 服务 器 应 用 程序 。 

步骤 1: 引入 以 下 命名 空间 。 


using System; 
using System. IO; 
using System. I0.Pipes; 


步骤 2: 在 using 语句 块 中 实例 化 NamedPipeServerStream 类 。 


using(NamedPipeServerStrean server = new NamedPipeServerStream("demo" )) 


{ 


Console. WriteLine(" 按 任意 键 退出 。"); 
Console. Read(); 


. 


调用 NamedPipeServerStream 构造 函数 时 ,传递 一 个 自 定义 名 称 , 此 名 称 可 以 唯一 确 
定 该 服务 器 管道 。 
步骤 3: 等 待 客户 端的 连接 。 


server. WaitForConnection( ); 
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步骤 4: 使 用 StreamReader 类 来 读 取 从 客户 端 发 来 的 消息 。 


try 
{ 


using(StreamReader reader = new StreamReader(server)) 
{ 
String msg = null; 
while( (msg = reader. ReadLine()) != null) 
{ 
Console. WriteLine( $ "客户 端 :{msg}"); 
I 
} 
} 


catch 


{ 
Console. WriteLine(" 发 生 了 错误 。"); 
¥ 


接 下 来 实现 客户 端 应 用 程序 。 
步骤 5: 引入 以 下 命名 空间 。 


using System; 
using System. IO; 
using System. I0. Pipes; 


步骤 6: 实例 化 NamedPipeClientStream 类 。 在 调用 构造 函数 时 ,传递 给 pipeName 参 
数 的 管道 名 称 必须 与 服务 器 管道 的 名 称 匹配 ,否则 无 法 进行 连接 。 


using(NamedPipeClientStrean client = new NamedPipeClientStream("deno")) 
{ 


} 

步骤 7: 向 服务 器 发 出 连接 请 求 。 

client. Connect(); 

步骤 8: 使 用 StreamWriter 类 来 写 人 要 发 送 的 消息 。 


using(StreamWriter writer = new StreamWriter(client)) 
{ 
writer. AutoFlush = true; 
while(true) 
{ 
Console. WriteLine(" 请 输入 要 发 送 的 内 容 :"); 
string msg = Console. ReadLine( ); 
if (!string. IsNullOrWhiteSpace(msg)) 
{ 
writer. WriteLine(msg); 
} 
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将 AutoFlush 属性 设置 为 true, 可 以 使 StreamWriter 实例 每 次 写 人 数据 后 自动 将 数据 
是 交 到 基础 的 NamedPipeClientStream 实例 中 ,从 而 达到 立刻 发 送 消 息 的 目的 。 

步骤 9: 在 Visual Studio 的 “解决 方案 资源 管理 器 ”窗口 中 , 右 击 解决 方案 名 称 , 从 快 
菜单 中 选择 属性 命令 ,打开 解决 方案 属性 窗口 。 
步骤 10: 在 启动 项 目 对 话 框 中 色 选 多 个 启动 项 目 ,然后 将 服务 器 和 客户 端 两 个 应 用 程 
序 项 目 都 设置 为 启动 , 单 击 确定 按钮 保存 ,这 样 在 运行 时 就 可 以 同时 启动 两 个 项 目 , 如 
图 8-18 所 示 。 


名 


口 当前 选 定 内 容 (R) 
口 单 启动 项 目 GS) 
DemoServer 
ENE 
项 目 择 作 
DemoClient ETEEEEEEEE 
DemoServer Em 


图 8-18 两 个 项 目 均 设置 为 启动 
步骤 11: 按 F5 快捷 键 同 时 运行 两 个 项 目 。 
步骤 12: 在 客户 端 中 输入 要 发 送 的 消息 , 按 Enter 键 确认 ,在 服务 器 程序 中 就 会 看 到 已 
接收 的 消息 ,如 图 8-19 所 示 。 


图 8-19 服务 器 与 客户 端的 输出 文本 
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实例 266” 单 向 管道 通信 


【导语 】 

在 调用 NamedPipeServerStream 和 NamedPipeClientStream 类 的 构造 函数 时 ,可 以 传 
递 一 个 direction 参数 ,该 参数 类 型 是 PipeDirection 枚 举 ,用 来 指定 管道 的 通信 方向 , 它 定义 
了 以 下 三 个 秆 。 

(1) Out: 管道 仅 为 输出 模式 , 即 只 能 写 人 消息 。 

(2) In: 管道 仅 为 输入 模式 , 即 只 读 通 信 。 

(3) InOut: 双向 通信 ,可 以 写 和 人 消息 ,也 可 以 读 取消 息 。 

当 未 指定 direction 参数 的 情况 下 ,默认 生成 双向 通信 的 管道 (InOut) 。 

本 实例 将 实现 单 向 通信 ,服务 器 只 能 用 于 发 送 消息 ,而 客户 端 只 能 读 取 消息 。 

【操作 流程 】 

以 下 是 服务 器 的 实现 步骤 。 

步骤 1: 引入 以 下 命名 空间 。 

using System; 


using System. IO; 
using System. I0.Pipes; 


步骤 2: 实例 化 NamedPipeServerStream 类 。 


using(NamedPipeServerStream server = new NamedPipeServerStream("test", PipeDirection. Out)) 


{ 


} 


在 调用 构造 函数 时 ,明确 指定 direction 参数 为 Out。 
步骤 3: 等 待 客户 端 连接 。 


server. WaitForConnection( ); 
步骤 4: 使 用 StreamWriter 类 来 写 信 消息。 


using(StreamWriter writer = new StreanmWriter(server)) 
{ 
writer. AutoFlush = true; 
Console. ForegroundColor = ConsoleColor. Yellow; 
Console. WriteLine(" 注 意 :可 输入 "end" 退 出 ,"); 
Console. ResetColor( ); 
while (true) 
{ 
Console. Write( "请 输入 要 发 送 的 消息 :"); 
string msg = Console. ReadLine(); 
if(msg.ToLower() == "end") 
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{ 
break; 
} 
writer. WriteLine(msg); 
server. WaitForPipeDrain( ); 


} 

为 了 可 以 发 送 多 条 消息 ,发 送 消息 的 代码 写 在 while 循环 中 , 当 输 入 的 内 容 为 “end” 时 
跳出 循环 。 发 送 消息 后 调用 一 次 WaitForPipeDrain 方法 ,可 以 使 服务 器 等 待 客户 端 收 到 消 
息 后 再 继续 发 送 后 续 的 消息 。 

以 下 是 客户 端的 实现 步骤 。 

步骤 5: 引入 以 下 命名 空间 。 

using System; 


using System. IO; 
using System. I0. Pipes; 


步骤 6: 实例 化 NamedPipeClientStream 类 。 


using(NamedPipeClientStream client = new NamedPipeClientStream("."，"test"，PipeDirection. 
In)) 
{ 


} 

该 代码 使 用 了 以 下 重 载 版 本 的 构造 函数 。 

NamedPipeClientStream( string serverNane, string pipeName, PipeDirection direction) 

serverName 指定 远程 计算 机 名 称 ,由 于 本 例 是 在 本 机 进行 测试 ,此 参数 可 以 使 用 “. ?或 
“localhost”。direction 参数 为 In, 即 可 读 通 信 。 

步骤 7: 连接 服务 器 。 

client. Connect(); 

步骤 8: 使 用 StreamReader 类 来 读 取 消息 。 


using(StreamReader reader = new StreamReader(client)) 
{ 
string msg = null; 
while( (nsg = reader. ReadLine()) != null) 
{ 
Console. WriteLine( $ "服务 器 : {msg}"); 
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步骤 9: 在 解决 方案 属性 中 将 两 个 应 用 项 目 都 设置 为 启动 项 目 。 
步骤 10: 同时 运行 两 个 项 目 ,在 服务 器 上 写 入 要 发 送 的 消息 , 按 Enter 键 确认 后 ,客户 
端 会 显示 接收 到 的 消息 ,如 图 8-20 所 示 。 


图 8-20 单 向 管道 通信 


村 


列 化 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。 简单 序列 化 方案 ; 

。 XML 序列 化 ; 

， 数据 协定 。 


9.1 简单 序列 化 方案 


实例 267 二进制 序列 化 
【导语 】 


序列 化 (Serialization ,也 可 以 翻译 为 “ 串 行 化 ”) ,就 是 将 某 个 对 象 实例 的 状态 信息 存储 
到 可 传输 介质 中 ,例如 内 存 中 ,文件 中 以 及 通过 网 络 发 送 的 数据 中 。 实 例 的 状态 信息 包括 对 


象 的 属性 和 字段 成 员 的 值 (不 包括 方法 和 事件 ) 。 
当 需 要 还 原 对 象 的 状态 信息 时 ,可 以 从 可 传输 介质 中 读 出 这 些 数据 ,重新 为 对 象 的 
或 字段 成 员 赋 值 , 此 过 程 称 为 反 序 列 化 (Deserialization) 。 


属性 


所 谓 二 进 制 序列 化 ,就 是 将 对 象 实例 的 状态 信息 以 二 进 制 的 方式 存储 ,这 样 产 生 数 据 的 
体积 小 ,但 不 便于 在 不 同 的 网 络 平台 之 间 传 输 。 要 让 自 定义 类 型 支持 二 进 制 序列 化 ,需要 在 


类 型 上 应 用 SerializableAttribute。 
【操作 流程 】 
步骤 1: 新建 控 制 台 应 用 程序 项 目 。 


步骤 2: 声明 一 个 Person 类 ,包含 两 个 公共 属性 , 稍 后 会 将 Person 类 的 实例 进行 序列 


化 和 反 序 列 化 。 


[Serializable] 

class Person 

{ 
public string Name { get; set; } 
public int Mge { get; set; } 
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注意 : 让 类 型 支持 二 进 制 序列 化 ,必须 应 用 SerializableAttribute。 但 类 型 是 否 需 要 定义 为 
公共 类 型 ,是 可 选 的 。 


步骤 3: 声明 一 个 字符 串 变 量 用 于 存放 序列 化 数据 的 文件 名 ,本 实例 会 将 Person 实例 
的 状态 信息 保存 到 文件 中 。 


string fileName = "demo. data"; 
步骤 4: 执行 序列 化 。 


using(FileStrean fs = new FileStream(fileName, FileMode.OpenOrCreate)) 
{ 
BinaryFormatter ft = new BinaryFormatter(); 
// 创建 Person 类 实例 
Person ps = new Person 
{ 
Name = "Jack", 
Age = 28 
}; 
ft. Serialize(fs, ps); 
} 


二 进 制 序列 化 用 到 的 是 BinaryFormatter 类 (需要 引入 System. Runtime. Serialization. 
Formatters. Binary 命名 空间 ) ,序列 化 时 只 要 调用 Serialize 方法 即 可 。 
步骤 5: 执行 反 序列 化 ,还 原 Person 对 象 的 状态 。 


using(FileStrean fs = new FileStream(fileName，FileMode.Open) ) 
{ 

BinaryFormatter ft = new BinaryFormatter(); 

// 从 已 保存 的 数据 中 读 出 Person 实例 

Person ps = (Person)ft.Deserialize(fs); 

// 输出 实例 的 属性 值 

Console. WriteLine( $ "Name: {ps. Name} \nAge: {ps. Age}"); 


} 
反 序 列 化 调用 Deserialize 方法 ,该 方法 返回 的 类 型 为 object, 因 此 需要 强制 进行 类 型 转换 。 
步骤 6: 运行 应 用 程序 ,输出 反 序列 化 的 属性 值 如 下 。 


Name: Jack 
age: 28 


实例 268 ”使 用 DataContractSerializer 类 进行 序列 化 


【导语 】 

DataContractSerializer 类 是 与 数据 协定 配套 使 用 的 类 ,但 它 也 可 以 对 未 应 用 协定 特性 
的 普通 类 型 进行 序列 化 和 反 序 列 化 。 默 认 情 况 下 ,DataContractSerializer 类 将 对 象 实例 序 
列 化 为 XML 数据 。 序 列 化 可 调用 WriteObject 方法 ,而 反 序列 化 可 调用 ReadObject 方法 。 


[人 
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【操作 流程 】 
步骤 1: 新 建 一 个 控制 应 用 程序 项 目 。 
步骤 2: 引入 以 下 命名 空间 。 


using System; 
using System. IO); 
using System. Runtime. Serialization; 


步骤 3: 声明 一 个 Student 类 , 稍 后 用 于 演示 序列 化 和 反 序 列 化 。 


public class Student 
{ 
public int ID { get; set; } 
public string Name { get; set; } 
public string City { get; set; } 
} 


DataContractSerializer 类 在 序列 化 时 不 要 求 应 用 SerializableAttribute, 因此 Student 
类 上 面 不 需要 该 特性 。 
步骤 4: 执行 序列 化 。 


using(FileStrean fs = new FileStream(fileName, FileMode.OpenOrCreate)) 
{ 


DataContractSerializer dcs = new DataContractSerializer(typeof(Student)); 
Student s = new Student 
{ 


ID = 1003, 
Name = "Zhang", 
City = "BJ" 


}; 
dcs. WriteObject(fs, s); 


} 
步骤 5: 执行 反 序 列 化 。 


using(FileStrean fs = new FileStream(fileName, FileMode.Open)) 


{ 
DataContractSerializer dcs = new DataContractSerializer(typeof(Student)); 
Student s = dcs.ReadObject(fs) as Student; 


// 输出 属性 值 
Console. WriteLine( $ "ID: {s. ID} \nName: {s.Name}\nCity: {s.City}"); 


$ 


步骤 6: 运行 应 用 程序 , 反 序 列 化 得 到 的 Student 实例 状态 如 
图 9-1 所 示 。 

DataContractSerializer 类 在 序列 化 Student 对 象 后 可 生成 如 下 的 
XML 内 容 。 


< Student xmlns = " http://schemas. datacontract. org/2004/07/Demo" 


xmlns:i= "http://www. w3.org/2001/XMLSchema - instance"> 图 9-1 反 序列 化 后 的 


Student 实例 
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<City> BJ </City> 
<ID>1003 </ID> 
< Name > Zhang </Name > 


</Student > 
实例 269 ”将 类 型 实例 序列 化 为 JSON 格式 
【导语 】 


DataContractJsonSerializer 类 (位 于 System. Runtime. Serialization. Json 命名 空间 中 ) 
支持 把 类 型 实例 序列 化 为 JSON 数据 格式 。JSON 格式 数据 的 体积 小 ,结构 简单 ,在 跨 平 台 
与 跨 网 络 传输 数据 时 更 为 方便 ,因此 在 Web 领域 被 广泛 使 用 。 

【操作 流程 】 

步骤 1: 新建 控 制 台 应 用 程序 项 目 。 

步骤 2: 声明 Pet 类 , 它 包 含 三 个 公共 属性 , 稍 后 将 演示 如 何 将 包含 Pet 对 象 的 数组 序 
列 化 为 JSON 数据 。 


public class Pet 

{ 
public string Name { get; set; } 
public int Age { get; set; } 
public string Owner { get; set; } 

} 


步骤 3: 执行 序列 化 。 


using (FileStream strean = File.Open(fileName, FileMode.OpenOrCreate)) 
{ 


Pet[] pets = 

{ 
new Pet { Name = "Dog A", Age = 3, Owner = "Jack" }, 
new Pet { Name = "Cat E", Age = 2, Owner = "Bob" } 


}; 
DataContractJsonSerializer sz = new DataContractJsonSerializer(pets. GetType()); 
sz. WriteObject(stream, pets); 

} 


步骤 4: 执行 反 序列 化 。 


using(FileStrean fs = File.OpenRead(fileName)) 
DataContractJsonSerializer sz = new DataContractJsonSerializer(typeof (Pet[])); 
Pet[] petsarr = (Pet[])sz.ReadObject(fs); 
// 输出 数组 中 的 元 素 
foreach(Pet p in petsarr) 
{ 
Console. WriteLine( $ "Name: {p.Name}\nAge: {p. Age} \nOwner: {p.Owner}\n"); 


;i 
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注意 : 由 于 序列 化 和 反 序 列 化 的 实际 类 型 是 数组 类 型 ,因此 在 实例 化 DataContractJsonSerializer 
类 时 应 该 将 type 参数 指定 为 typeof(PetL]) 。 


步骤 5: 运行 应 用 程序 , 反 序列 化 后 得 到 的 内 容 如 图 9-2 所 示 。 
本 实例 序列 化 Pet 数组 后 产生 如 下 JSON 文档 。 


[ 
{ 
"age" : 3, 
"Name" : "Dog R"， 
"Owner" :， "Jackn 


图 9-2 从 JSON 文件 中 
反 序 列 化 后 
"age" : 2, 的 数组 实例 


由 于 原 对 象 是 数组 类 型 ,所 以 生成 的 JSON 对 象 会 被 一 对 中 括号 ([]) 括 起 来 。 
实例 270 在 序列 化 时 忽略 某 些 字段 


【导语 】 

在 序列 化 时 经 常会 忽略 类 型 中 一 些 字段 的 值 , 例 如 私有 字段 。 忽 略 类 型 中 特定 字段 的 
值 , 需 要 在 字段 上 应 用 NonSerializedAttribute。 对 于 没有 应 用 NonSerializedAttribute 的 字 
段 ,默认 情况 下 会 被 序列 化 。 在 反 序 列 化 时 ,不 会 读 取 应 用 了 NonSerializedAttribute 的 字 
段 ,而 是 保持 其 默认 值 不 变 ( 假 设 字段 是 int 类 型 ,那么 它 的 默认 值 为 0) 。 

【操作 流程 】 

步骤 1: 新 建 控 制 台 应 用 程序 项 目 。 

步骤 2: 本 实例 将 序列 化 的 数据 存放 在 内 存 中 ,因此 需要 创建 以 下 内 存 流 实 例 。 


MemoryStrean mstrean =- new MemoryStreanm(); 

步骤 3: 创建 BinaryFormatter 实例 。 
BinaryFormatter ft = new BinaryFormatter(); 

步骤 4: 声明 一 个 Car 类 , 稍 后 用 于 序列 化 测试 。 


[Serializable] 

public class Car 

{ 
public string Color; 
public decimal Speed; 
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[NonSerialized] 
public decinal Weight; 
} 


Car 类 包含 三 个 公共 字段 ,其 中 Weight 字段 应 用 了 NonSerialized 特性 ,序列 化 时 该 字 
段 会 被 忽略 。 
步骤 5: 创建 一 个 Car 类 的 实例 并 为 各 个 字段 赋值 。 


Car cl = new Car 

{ 
Color = "White", 
Speed = 165.2M, 
Weight = 2325.6M 


}; 
步骤 6: 将 上 述 Car 实例 进行 二 进 制 序列 化 。 
ft. Serialize(mstream, c1); 


步骤 7: 内 存 流 的 当前 位 置 位 于 流 的 末尾 ,如 果 此 时 进行 反 序列 化 是 读 不 到 数据 的 ,所 
以 要 先 将 内 存 流 的 当前 位 置 移 到 流 的 开始 处 。 


mstream. Position = OL; 
步骤 8: 进行 反 序列 化 ,然后 在 控制 台 输出 反 序列 化 后 Car 实例 各 字段 的 值 。 


Car c2 = (Car)ft.Deserialize(nstreanm); 


// 输出 各 字段 的 值 
Console. WriteLine( $ "Color: {c2.Color}\nSpeed: {c2. Speedj\nNeight: {c2.Weight}"); 


步骤 9: 使 用 完 后 要 释放 内 存 流 实例 。 

mstream. Dispose( ); 

步骤 10: 运行 应 用 程序 ,控制 台 输 出 结果 如 下 。 
Color: White 

Speed: 165.2 

Weight: 0 


从 反 序 列 化 得 到 的 结果 可 以 看 出 , Weight 字段 仅仅 保留 了 其 默认 值 0。 
9.2 XML 序列 化 


实例 271 XmlSerializer 与 XML 序列 化 


【导语 】 
在 System. Xml. Serialization 命名 空间 下 ,框架 提供 了 一 系列 专用 于 XML 序列 化 的 类 


qr 
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型 。 其 中 主要 的 类 是 XmlSerializer, 它 负责 执行 序列 化 和 反 序 列 化 任务 ,其 使 用 方法 与 
BinaryFormatter 类 相似 。 但 是 XmlSerializer 只 能 对 公共 类 型 (用 public 关键 字 修 饰 的 
类 型 ) 进 行 序列 化 , 非 公 共 类 型 会 发 生 异 常 ; 而 且 只 序列 化 公共 类 型 中 的 公共 成 员 , 非 公共 
成 员 会 被 忽略 。 

本 实例 将 演示 通过 XmlSerializer 类 对 类 型 实例 进行 简单 的 序列 化 与 反 序 列 化 操作 。 
【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 TaskItem 类 ,包含 五 个 公共 属性 。 


public class TaskItem 

{ 
public int TaskID { get; set; } 
public DateTime StartTime { get; set; } 
public DateTime FinishTime { get; set; } 
public string TaskName { get; set; } 
public string TaskDesc { get; set; } 

} 


步骤 3: 序列 化 TaskItem 实例 。 


using(FileStrean fs = new FileStream(fileName, FileMode.OpenOrCreate)) 
{ 
TaskItem item = new TaskItem 
{ 
TaskID = 1001, 
StartTime = new DateTime(2018, 9, 6, 14, 30, 0), 
FinishTime = new DateTime(2018, 9, 7, 18, 0, 0), 
TaskName = "Track #1", 
TaskDesc = "Do Something"” 
}; 
XmlSerializer xmlsz = new XmlSerializer(itenm.GetType()); 
xmlsz. Serialize(fs, item); 


步骤 4: 执行 反 序列 化 , 读 出 TaskItem 实例 的 状态 。 


using(FileStrean fs = new FileStream(fileName，FileMode.Open) ) 
{ 
XmlSerializer xsz - new XmlSerializer(typeof(TaskItem) ); 
TaskIten item = (TaskItem)xsz. Deserialize(fs); 
Console. WriteLine( $ "Task ID: {item. TaskID} \nTask Name: {item. TaskName} \nStart: {iten. 
StartTime} \nFinish: {item. FinishTime}\nDesc: {item. TaskDesc}"); 
} 


步骤 5: 运行 应 用 程序 ,控制 台 输出 反 序列 化 后 Taskltem 实例 中 各 属性 的 值 ,如 图 9-3 
所 示 。 


334 二 .NET Core 实战 一 -手把手 教 你 掌握 380 个 精彩 案例 


图 9-3 反 序列 化 得 到 的 TaskItem 实例 
TaskItem 实例 序列 化 后 生成 如 下 的 XML 文档 。 


<?xml version = "1.0"?> 
< TaskItem xmlns:xsi= "http://www. w3. org/2001/XMLSchema - instance" 
xmlns:xsd = "http://www. w3.org/2001/XMLSchema"> 

< TaskID> 1001 </TaskID> 

< StartTime> 2018— 09 - 06T14:30:00 </StartTime> 

<FinishTine> 2018 - 09 — 07T18:00:00 </FinishTine> 

< TaskName> Track #1</TaskName > 

< TaskDesc> Do Something </TaskDesc > 
</TaskItem> 


实例 272” 自 定义 封装 集合 类 型 成 员 的 XML 元 素 名 称 

【导语 】 

如 果 类 型 的 某 个 成 员 ( 属 性 或 字段 ) 是 集合 类 型 (如 数组 .List< T > 等 ) ,该 成 员 在 XML 
序列 化 时 ,需要 生成 一 个 用 于 包装 集合 子 项 的 XML 元 素 。 默 认 情 况 下 ,包装 子 项 的 XML 
元 素 名 称 与 成 员 名 称 相同 ,例如 某 个 类 中 包含 以 下 属性 。 

public SubItem[ ] InnerItems { get; set; } 


那么 在 XML 序列 化 时 ,包装 列表 项 的 XML 元 素 可 以 按 以 下 形式 命名 为 InnerItems。 


< InnerItems > 
<SubItem> … </SubItem> 


</InnerItems> 


如 果 需 要 改变 默认 包装 元 素 的 名 称 , 可 以 在 InnerItems 属性 上 应 用 XmlArrayAttribute, 对 
应 如 下 代码 。 


[xmlarray("Inners")] 
public SubITtem[ ] InnerItems { get; set; } 


修改 之 后 生成 的 XML 文档 如 下 。 


<Inners> 
<SubItem> … </SubItem> 
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</Inners> 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Test 类 ,包含 两 个 集合 类 型 的 属性 。 


public class Test 

{ 
public double[ ] Values { get; set; } 
[XmlArray("Strs")] 
public List < string> StringList { get; set; } 


} 

Values 属性 没有 应 用 XmlArrayAttribute; 因 此 它 序列 化 后 的 XML 元 素 名 称 与 属性 名 
称 相同 。 而 StringList 属性 应 用 了 XmlArrayAttribute, 序 列 化 后 生成 的 XML 元 素 名 为 
Strs。 


步骤 3: 将 Test 类 的 实例 进行 XML 序列 化 ,并 将 序列 化 后 的 数据 保存 到 内 存 流 中 。 


using(MenoryStream ms = new MemoryStream()) 
{ 
Test t = new Test 
{ 
Values = new double[] 
{ 
0.33d, 1.10005d, 12.456d 
}, 
StringList = new List< string> 
{ 
Sook 1 “Toast 2", "Tut 3 
和 
}; 
XmlSerializer sz = new XmlSerializer(typeof(Test)); 
sz. Serialize(nms, t); 
// 输出 XML 文档 
ms. Position = OL; 
using(StreamReader reader = new StreamReader(ms)) 
{ 
Console. WriteLine( reader. ReadToEnd( ) ); 


} 


将 Test 实例 进行 XML 序列 化 后 ,使 用 StreamReader 类 从 内 存 流 中 读 出 所 有 内 容 , 并 
将 内 容 输出 到 控制 台 。 
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步骤 4: 运行 应 用 程序 ,序列 化 产生 的 XML 文档 如 下 。 


<?xml version = "1.0"?> 


< Test xmlns:xsi= "http://www.w3.org/2001/XMLSchema - instance" 


xmlns:xsd = "http://www.w3.org/2001/XMLSchema"> 
< Values> 
< double> 0.33 </double> 
< double>1.10005 </double> 
< double> 12.456 </double> 
</Values > 
< Strs> 
< string> Test 1 </string> 
< string> Test 2 </string > 
< string> Test 3 </string> 
</Strs> 
</Test> 


在 上 述 XML 文档 中 ,封装 StringList 属性 的 XML 元 素 名 称 已 变 为 Strs 。 
实例 273” 自 定义 XML 元 素 的 名 称 


【导语 】 
XML 序列 化 会 默认 产生 与 类 型 成 员 ( 公 共 属 性 
些 应 用 场合 中 需要 改变 生成 的 XML 元 素 的 名 称 。 


或 公共 字段 ) 名 称 相 同 的 元 素 ,但 在 一 


有 两 个 Attribute 常用 于 自 定义 XML 元 素 的 名 称 : XmlRootAttribute 可 应 用 于 类 型 
(例如 类 、 枚 举 、 结 构 等 ), 以 自 定义 序列 化 所 产生 的 XML 文档 的 根 元 素 名 称 。 
XmlElementAttribute 可 应 用 于 类 型 成 员 , 以 自 定义 生成 的 XML 元 素 的 名 称 。 


【操作 流程 】 
步骤 1: 新 建 控制 台 应 用 程序 项 目 。 


步骤 2: 声明 Production 类 ,用 于 稍 后 做 序列 化 测试 。 在 定义 该 类 时 应 用 了 XmlRoot 


特性 ,指定 根 元 素 的 名 称 为 prod_info, 并 在 各 个 公共 
每 个 子 元 素 的 名 称 。 


[XmlRoot("prod_info")] 

public class Production 

{ 
[XmlElenent("prod_id")] 
public long ProductID { get; set; } 
[XmlElenent("prod time")] 
public DateTime ProductTime { get; set; } 
[XmlElenment("prod_size")] 
public float ProductSize { get; set; } 
[XmlElenent("prod_remarks")] 
public string ProductRemarks { get; set; } 


属 特 


E 上 应 用 XmlElement 特性 ,以 指定 
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步骤 3: 以 下 代码 将 Production 类 的 实例 序列 化 并 保存 到 一 个 XML 文件 中 。 


using(FileStrean fs = new FileStream("data. xml", FileMode.Create)) 
{ 
// 实例 化 Production 类 
Production prd = new Production 
和 
ProductID = 7078201, 
ProductTime = new DateTime(2018, 1, 3), 
ProductSize = 37.33f, 
ProductRemarks = "new style" 
}; 
// 输出 序列 化 前 的 状态 
StringBuilder strbd = new StringBuilder(); 
strbd. ARppendLine( $ "产品 ID: {prd. ProductID}"); 
strbd. AppendLine( $ "生产 日 期 :{prd. ProductTine:d}"); 
strbd. AppendLine( $ "尺寸 :{prd. ProductSize}"); 
strbd. AppendLine( $ "备注 :{prd. ProductRemarks}"); 
Console. Write(strbd + "\n\n"); 
// 进行 序列 化 
XmlSerializer serializer = new XmlSerializer(prd.GetType()); 
serializer. Serialize(fs, prd); 


} 
步骤 4: 读 取 并 输出 序列 化 后 生成 的 XML 文件 。 


using(FileStrean fs = new FileStream("data. xnml", FileMode. Open)) 
4 
using(StreamReader reader = new StreamReader(fs)) 
{ 
string xml = reader. ReadToEnd(); 
Console. friteLine(" 序 列 化 后 生成 的 XML 文档 :"); 
Console. Write(xml); 


} 
步骤 5: 运行 应 用 程序 ,序列 化 后 生成 的 XML 文档 如 下 。 


<?xml version = "1.0"?> 
< prod_info xmlns:xsi = "http://www.w3.org/2001/XMLSchema — instance" 
xmlns:xsd = "http://www.w3.org/2001/XMLSchema"> 
<prod id>7078201 </prod_id> 
< prod time> 2018- 01— 03T00:00:00</prod time> 
< prod_size> 37.33 </prod_size> 
< prod_remarks > new style</prod_remarks> 
</prod_info> 


从 上 述 XML 文档 可 以 发 现 ,文档 的 根 元 素 的 名 称 已 变 为 prod_info, ProductID 


属性 对 
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应 的 XML 元 素 名 称 变 为 prod_id, 其 他 属性 的 名 称 也 以 此 类 推 。 
实例 274 ”将 类 型 成 员 序 列 化 为 XML 特性 


【导语 】 

默认 的 序列 化 方案 会 把 类 型 成 员 ( 主 要 是 公共 属性 和 公共 字段 ) 序 列 化 为 XML 元 素 ， 
但 是 如 果 在 类 型 成 员 上 应 用 XmlAttributeAttribute( 第 二 个 “Attribute” 是 特性 类 的 约定 名 
称 , 在 代码 中 使 用 时 可 以 直接 忽略 第 二 个 “Attribute”) ,就 可 以 通知 序列 化 程序 将 类 型 的 成 
员 序 列 化 为 XML 特性 。 

例如 类 型 A 有 个 公共 属性 工 , 默 认 的 序列 化 结果 如 下 。 


< 及 > 
< 了 了 >， </T> 
</A> 


应 用 了 XmlAttribute 特性 后 的 序列 化 结果 如 下 。 
<AT="%" /> 
【操作 流程 】 


步骤 1: 新 建 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 Test 类 , 它 包 含 三 个 公共 字段 , 稍 后 将 用 于 序列 化 。 


[XmlRoot("demo_test")] 

public class Test 

{ 
[XmlAttribute("val a")] 
public int ValueA; 
[XmlAttribute("val b")] 
public bool ValueB; 
[XmlAttribute("val c")] 
public string ValueC; 

} 


应 用 XmlAttribute 特性 时 还 可 以 自 定 义 其 名 称 ,如 果 不 指 定名 称 , 则 默认 与 字段 的 名 
称 相 同 。 例 如 , 若 ValueA 字段 上 不 指定 自 定义 的 XML 特性 名 ,那么 序列 化 后 生成 的 XML 
特性 名 称 为 ValueA; 本 例 中 已 指定 名 称 为 val_a, 那 么 序列 化 后 生成 的 XML 特性 名 称 就 会 
是 val a。 

步骤 3: 实例 化 内 存 流 ,序列 化 产生 的 XML 文档 将 存放 在 内 存 流 中 。 

MemoryStream ms = new MemoryStream(); 

步骤 4: 实例 化 Test 类 ,并 为 各 字段 赋值 。 


Test t = new Test 
' 
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ValueR = 60000, 
ValueB = true, 
ValueC = "Start up" 


}; 
步骤 5: 执行 序列 化 操作 。 


XmlSerializer sz = new XmlSerializer(t.GetType()); 
sz. Serialize(ms, 七 ); 


步骤 6: 从 内 存 流 中 读 出 序列 化 后 生成 的 XML 文档 。 


ms. Position = 0L; 
String xnlDoc = null; 
using(StreamReader reader = new StreamReader(ms)) 
{ 
xmlDoc = reader. ReadToEnd!(); 
} 


往 内 存 流 中 写 人 数据 后 流 的 当前 位 置 在 末尾 .因此 要 把 Position 属性 设置 为 0. 使 流 的 
当前 位 置 回 到 流 的 首位 ,和 否则 读 不 到 内 容 。 
Test 实例 序列 化 之 后 生成 如 下 的 XML 文档 。 


<?xml version= "1.0"?> 

< demo_test xmlns:xsi="..." xmlns:xsd= "..." 
val_a= "60000" 
val_b= "true" 
val_c= "Start up" 

人 > 


实例 275 自 定义 XML 命名 空间 


【导语 】 
XmlRootAttribute、 XmlElementAttribute 和 XmlAttributeAttribute 特性 类 都 公开 了 
-个 Namespace 属性 , 它 的 作用 是 设置 XML 序列 化 时 各 个 XML 文档 对 象 的 命名 空间 。 

XML 命名 空间 一 般 使 用 URL 形式 (如 http: //xxx. net), 这 是 因为 URL 的 唯一 性 不 易 造 
成 命名 空间 的 重复 ,当然 也 可 以 使 用 其 他 命名 形式 (例如 , 叫 my. test) 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Test 类 ,用 于 序列 化 测试 ,该 类 包含 两 个 公共 属性 。 


[XmlRoot(Nanespace = "test.org")] 
public class Test 
{ 
[XmlElenent(Nanmespace = "test.org/prop")] 
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public int Valuel { get; set; } 
[XmlElenent(Namespace = "test.org/prop")] 
public string Value2 { get; set; } 

} 

在 Test 类 上 ,通过 XmlRoot 特性 类 的 Namespace 属性 指定 一 个 自 定义 的 命名 空间 
test. org。 在 公共 属性 上 ,通过 XmlElement 特性 类 的 Namespace 属性 指定 命名 空间 为 
test. org/ prop。 

步骤 3: 在 Main 方法 中 ,将 Test 类 的 实例 序列 化 并 存放 到 内 存 流 上 ,然后 从 内 存 流 中 
读 出 生成 的 XML 文档 。 


using(MemoryStream ns = new MemoryStream()) 


tf 


Test vt = new Test 
{ 
Valuel = 96, 
Value2 = "one 
}; 
XmlSerializer szr = new XmlSerializer(vt.GetType()); 
szr. Serialize(ms, vt); 


ms. Position = 0L; 
using(StreamReader rd = new StreamReader(ms)) 


{ 
string xml = rd.ReadToEnd(); 


Console. Write( $ "序列 化 后 生成 的 XML 文档 :\n{xn1}"); 


} 
步骤 4: 运行 应 用 程序 ,输出 的 XML 文档 如 下 。 


<?xml version = "1.0"?> 

< Test xmlns:xsi="..." xmlns:xsd="..." xmlns = "test.org"> 
<Valuel xmlns = "test. org/prop"> 96 </Valuel > 
< Value2 xmlns = "test, org/prop"> one</Value2 > 

</Test> 


在 Test 根 元 素 上 ,xmlns 王 "test, org" 为 自 定义 的 命名 空间 ; 同 理 ,在 Valuel 和 Value2 
元 素 上 ,xmlns 二 "test. org/prop" 为 自 定 义 的 命名 空间 。 


实例 276” 自 定 义 数组 类 型 成 员 的 XML 元 素 

【导语 】 

在 进行 XML 序列 化 时 ,数组 (或 者 List 及 其 他 集合 类 型 ) 类 型 结构 比较 特殊 ,因为 它 包 
含 一 系列 子 元 素 ,在 做 XML 封装 时 , 既 需 要 外 层 的 封装 元 素 ,也 需要 封装 内 部 子 元 素 。 默 
认 的 序列 化 方案 使 用 与 类 型 成 员 相同 名 称 的 XML 元 素来 包装 数组 实例 ,而 数组 实例 中 每 
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个 元 素 则 用 其 类 型 名 称 作 为 XML 元 素 的 名 称 。 若 数组 中 的 元 素 类 型 是 字符 串 ,那么 序列 
化 后 生成 的 XML 元 素 如 下 。 
< 成 员 名 称 > 


< string>…</string> 
< string>…</string> 


</ 成 员 名 称 > 

但 有 了 时 并 不 使 用 默认 的 序列 化 行为 ,如 果 要 对 数组 类 型 的 封装 做 自 定 义 处 理 .需要 用 到 
以 下 两 个 特性 类 。 

XmlArrayAttribute: 自 定义 包装 数组 对 象 的 元 素 , 用 法 与 XmlElementAttribute 相似 ， 
用 于 替换 默认 的 类 型 成 员 名 称 。 

XmlArrayItemAttribute: 用 于 替换 数组 中 子 元 素 的 默认 封装 名 称 。 

本 实例 将 对 比 演示 两 个 结构 相同 的 类 来 进行 ,其 中 一 个 类 采用 默认 序列 化 方案 ,而 另 一 
个 类 则 进行 了 自 定义 处 理 。 

【操作 流程 】 

步骤 1: 新 建 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Testl 类 ,该 类 不 使 用 任何 特性 修饰 。 


public class Test1 
{ 
public int ItemCount; 
public string[ ] Itens; 
} 


步骤 3: 声明 Test2 类 ,对 Items 字段 应 用 相关 的 特性 ,指定 成 员 封 装 元 素 名 为 item_ 
list, 数 组 中 元 素 的 封装 元 素 名 为 sub_item 。 


Public class Test2 

{ 
public int ItemCount; 
[XmlArray("item list")] 
[XmlArrayItem("sub item")] 
public string[ ] Ttems; 


} 
步骤 4: 两 个 类 的 序列 化 过 程 相似 ,为 了 避免 编写 过 多 的 重复 代码 ,可 以 统一 编写 一 个 
方法 来 执行 序列 化 ,通过 泛 型 参数 来 传递 Testl 或 Test2 实例 。 


static void Serialize<T>(T obj) 
{ 


using (MemoryStream ms = new MemoryStream()) 


{ 
XmlSerializer sz = new XmlSerializer(typeof(T)); 
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sz. Serialize(ms, obj); 


ms. Position = OL; 
using (StreamReader rd = new StreamReader(ms)) 
{ 

string xm]l = rd.ReadToEnd(); 

Console. Write(xml + "\n\n"); 


} 
步骤 5: 在 Main 方法 中 ,对 Testl .Test2 实例 分 别 进行 序列 化 。 


Testl tl = new Test1(); 

t1. Items = new string[] { "iten 1"，"item 2", "item 3" }; 
tl1. ItemCount = tl1. Items. Length'; 

Console.WriteLine(" 默 认 序列 化 方案 :"); 

Serialize(t1); 

Test2 t2 = new Test2(); 

t2. Items = new string[] { "iten 1"，"item 2"，"item 3" }; 
t2. ItemCount = t2. Items. Dength; 

Console. WriteLine(" 自 定义 序列 化 方案 :"); 

Serialize(t2); 


步骤 6: 运行 应 用 程序 ,观察 其 输出 的 结果 。 
对 于 默认 序列 化 方案 ,将 生成 以 下 XML 文档 。 


<?xml version = "1.0"?> 
<Testl …> 
< ItemCount > 3 </ItemCount > 
< Items> 
< string> item 1 </string> 
< string> item 2 </string> 
< string> item 3 </string> 
</Items > 
</Testl > 


对 于 自 定义 方案 ,将 生成 以 下 XML 文档 。 


<?xml version = "1.0"?> 
<Test2 …> 
< ItemCount > 3</ItemCount > 
< item list> 
< sub_item> iten 1 </sub_item > 
<sub item> iten 2</sub item> 
<sub item> iten 3 </sub_item > 
</item list> 
</Test2> 
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9.3 数据 协定 


实例 277 数据 协定 的 简单 定义 


【导语 】 

数据 协定 是 一 种 约定 , 它 要 求 参与 约定 的 类 型 以 及 其 成 员 结构 必须 匹配 ,但 类 型 以 及 类 
型 的 成 员 名 称 不 一 定 相 同 。 假 设 ,A 类 的 协定 名 称 为 user_a,P1l 属性 的 协定 名 称 为 pop_1， 
P2 属性 的 协定 名 称 为 pop_2。 用 A 类 的 实例 序列 化 之 后 生成 的 数据 去 填充 B 类 的 实例 , 虽 
然 BB 类 的 两 个 属性 分 别 为 V1 和 V2, 但 是 它 所 使 用 的 数据 协定 名 称 与 A 类 相同 .此 时 是 可 
以 顺利 进行 反 序列 化 的 ,因为 它们 均 符合 数据 协定 的 要 求 。 

数据 协定 最 大 的 作用 是 在 网 络 传输 中 保证 数据 模型 的 统一 ,即使 数据 的 发 送 方 与 接收 
方 声明 了 不 同 的 类 型 ,只 要 双方 遵守 数据 协定 ,就 可 以 完成 序列 化 与 反 序 列 化 。 

本 实例 仅仅 声明 一 个 简单 的 数据 协定 ,并 使 用 DataContractSerializer 类 进行 序列 化 ， 
然后 将 序列 化 的 结果 输出 到 控制 台 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Album 类 ,并 应 用 数据 协定 相关 的 类 。 


9 


[DataContract] 
public class Album 
{ 
[DataMenber] 
public string Title { get; set; } 
[DataMenber] 
public string Artist { get; set; } 
[DataMenber] 
public int Year { get; set; } 
[DataMenber] 
public string Cover { get; set; } 
} 


在 类 型 定义 上 应 当 使 用 DataContractAttribute, 而 DataMemberAttribute 类 只 应 用 于 
类 型 成 员 上 (一 般 是 字段 和 属性 ) 。 
步骤 3: 实例 化 内 存 流 ,用 于 存放 序列 化 后 生成 的 数据 。 


using(MenoryStream ms = new MemoryStream()) 


{ 


' 
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步骤 4: 创建 Album 实例 。 


Albun ab = new Album 

{ 
Title = "Lee Songs", 
Year = 2007, 
Artist = "Lee Tan"， 
Cover = "05. jpg" 

}; 


步骤 5: 执行 序列 化 。 


DataContractSerializer szr = new DataContractSerializer(ab. GetType()); 


szr. WriteObject(ms, ab); 
步骤 6: 读 取 并 显示 序列 化 的 结果 ,此 结果 是 


ms. Position = 0L; 


-个 XML 文档 。 


using(StreanReader reader = new StreanReader(ms)) 


{ 
string data = reader. ReadToEnd(); 


Console. WriteLine( $ "序列 化 后 的 内 容 如 下 :\n{data}"); 


} 


步骤 7: 运行 应 用 程序 ,数据 协定 序列 化 后 生成 的 XML 文档 如 下 。 


<Album xmlns = "-…" xmlns:i="."><Artist> Lee 


Tan </Artist > < Cover > 05. jpg </Cover > < Title 
</Album> 


> Lee Songs </Title > < Year > 2007 </Year > 


DataContractSerializer 类 采用 XML 格式 进行 序列 化 .产生 的 结果 与 XmlSerializer 类 


相似 ,但 DataContractSerializer 类 会 删除 XML 文 
便于 网 络 传输 。 


实例 278” 自 定义 协定 的 名 称 


【导语 】 

与 XML 相似 , 数据 协定 也 可 以 进行 
DataMemberAttribute 类 都 公开 了 Name 属性 ,该 
名 称 与 类 型 名 称 相同 )。 

本 实例 将 演示 自 定义 数据 协定 名 称 的 方法 。 
【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 Disk 类 , 它 包 含 两 个 公共 属性 。 


[DataContract(Name = "disk info")] 


档 中 的 空白 字符 ,尽量 地 压缩 文档 体积 ， 


自 定义 。DataContractAttribute 类 与 
属性 的 作用 是 改变 协定 的 默认 名 称 ( 默 认 
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public class Disk 

{ 
[DataMenber(Name = "total_space")] 
public long Space { get; set; } 
[DataMenber(Name = "driver type")] 
public byte Type { get; set; } 

} 


步骤 3: 将 Disk 实例 进行 序列 化 ,并 将 结果 写 人 文件 。 


using (FileStream fs = File.Open("data.xml"，FileMode. Create) ) 
{ 
Disk d = new Disk 
{ 
Space = 560008210310, 
Type = 0x0C 
}; 
DataContractSerializer sz = new DataContractSerializer(d. GetType()); 
sz. WriteObject(fs, d); 
} 


步骤 4: 从 保存 的 文件 中 读 出 XML 文档 ,输出 到 控制 台 。 


using(StreamReader reader = new StreanReader("data. xml")) 
{ 

Console. Write( "序列 化 后 输出 的 结果 :\n"); 

Console. Write( reader. ReadToEnd( ) ); 


步骤 5: 运行 应 用 程序 ,Disk 类 实例 在 序列 化 后 输出 的 XML 文档 如 下 。 


<disk_info …> 
< driver_type> 12 </driver_type> 
< total_space> 560008210310 </total_space > 
</disk_info> 
从 输出 结果 看 到 ,文档 的 根 元 素 已 命名 为 disk_info ,两 个 成 员 依次 命名 为 driver_type 
和 total_space, 而 不 是 使 用 类 型 默认 的 名 称 。 


实例 279 ”不同 的 类 型 使 用 相同 的 数据 协定 


【导语 】 

本 实例 将 展示 数据 协定 的 用 途 一 一 对 于 结构 相同 而 命名 不 同 的 类 型 ,只 要 使 用 一 致 的 
数据 协定 ,就 能 完成 序列 化 与 反 序列 化 ,这 样 的 设计 模式 是 为 了 实现 跨 网 络 、 跨 应 用 、 跨 平台 
传输 数据 。 

本 实例 中 将 用 到 两 个 类 : StudentV1 与 StudentV2, 虽 然 类 型 名 称 和 成 员 名 称 不 同 , 但 
它们 结构 相同 ,成 员 的 数据 类 型 也 相同 ,只 要 它们 使 用 一 致 的 数据 协定 ,就 可 以 通过 序列 化 
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来 传递 。 在 本 例 中 ,将 StudentV1 类 的 实例 进行 序列 化 ,在 反 序列 化 时 则 使 用 StudentV2 
类 型 的 变量 进行 接收 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 StudentV1 类 和 StudentV2 类 。 


[DataContract(Namespace = "demo", Name = "stu data")] 
public class StudentV1 
{ 

[DataMenmber(Name = "stu id")] 

public long ID { get; set; } 

[DataMenber(Name = "stu name")] 

public string Name { get; set; } 

[DataMenber(Name = "stu_email")] 

public string Enail { get; set; } 


[DataContract(Namespace = "demo", Name = "stu data")] 
public class StudentV2 
{ 
[DataMenber(Name = "stu id")] 
public long StudentID { get; set; } 
[DataMember(Name = "stu name")] 
public string StudentName { get; set; } 
[DataMenmber(Name = "stu email")] 
public string StudentEmail { get; set; } 


注意 : 对 于 DataContractAttribute 而 言 ,如 果 要 严格 规范 数据 协定 的 名 称 ,应 当 同 时 设置 
Namespace 属性 与 Name 属性 ,以 提高 数据 协定 的 唯一 性 与 准确 性 。 


步骤 3: 将 StudentV1 实例 序列 化 ,输出 结果 写 人 XML 文件 。 


using(FileStrean fs = new FileStream("test.xnml", FileMode. Create) ) 
{ 
StudentV1 st1l = new StudentV1 
{ 
ID = 201811428023, 
Name = "Zhao"， 
Email = "t003@21cn. com" 
}; 
DataContractSerializer szr = new DataContractSerializer(st1. GetType()); 
szr. WriteObject(fs, st1); 


a 
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步骤 4: 从 该 XML 文件 中 读 入 数据 , 进行 反 序 列 化 ,但 接收 状态 信息 的 类 型 是 
StudentV2。 


using(FileStrean fs = new FileStream("test. xml", FileMode. Open)) 


{ 
DataContractSerializer sz = new DataContractSerializer(typeof(StudentV2)); 


StudentV2 st2 = (StudentV2)sz.ReadObject(fs); 


string msg = "序列 化 后 的 状态 信息 :\n"” + 
$ "学 员 姓 名 : {st2. StudentName}\n" + 
$ "学 员 编 号 :{st2. StudentID}\n" + 
$ "学 员 电邮 :{st2. StudentEmail}"; 
Console. Write(msg); 
} 图 9-4 反 序 列 化 后 的 


步骤 5; 运行 应 用 程序 ,控制 台 输出 结果 如 图 9-4 所 示 。 本人 
实例 280 ”将 数据 协定 序列 化 为 JSON 格式 


【导语 】 

DataContractSerializer 类 默认 将 数据 协定 以 XML 格式 序列 化 ,车 需要 序列 化 为 JSON 
格式 ,就 得 使 用 DataContractJsonSerializer 类 (位 于 System. Runtime. Serialization. Json 命 
名 空间 ) ,该 类 的 使 用 方法 与 DataContractSerializer 类 是 一 样 的 ,只 是 输出 的 数据 格式 不 同 
而 已 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Sample 类 , 它 包含 三 个 公共 字段 。 


[DataContract] 

public class Sample 

{ 
[DataMenber(Neme = "val 1")] 
public double TestVall; 
[DataMenber(Name = "val 2")] 
public DateTime TestVal2; 
[DataMenber(Name = "val 3")] 
public uint TestVal3; 


注意 : 由 于 JSON 对 象 是 使 用 一 对 大 括号 括 起 来 的 ,没有 根 元 素 , 因 此 在 应 用 
DataContractAttribute 时 可 以 忽略 Namespace 和 Name 属性 。 


步骤 3: 执行 序列 化 ,并 将 结果 输出 到 文件 中 。 


348 二 | .NET Core 实战 一 -手把手 教 你 掌握 380 个 精彩 案例 


using(FileStrean fs = new FileStream("data. json", FileMode. Create)) 
{ 

Sample sl = new Sample 

{ 


TestVall = 333.6515d, 
TestVal2 = DateTine. Now, 
TestVal3 = 797001 


}; 
DataContractJsonSerializer jsonsz = new DataContractJsonSerializer(typeof(Sample)); 
jsonsz. WriteObject(fs, s1); 


. 


步骤 4: 执行 反 序列 化 ,从 文件 中 读 出 数据 ,填充 一 个 Sample 类 的 实例 ,然后 在 控制 台 
输出 各 个 公共 字段 的 值 。 


using(FileStrean fs = new FileStream("data. json", FileMode. Open)) 

{ 
DataContractJsonSerializer jssz - new DataContractJsonSerializer(typeof(Sample)); 
Sample obj = jssz.ReadObject(fs) as Sample; 
Console. Write ( $ " {nameof ( Sample. TestVall)} = {obj. TestVall} \ n {nameof (Sample. 
TestVal2)} = {obj.TestVal2}\n{nameof(Sample. TestVal3)} = {obj.TestVal3}"); 

} 


步骤 5: 运行 应 用 程序 ,Sample 类 实例 被 序列 化 后 得 到 如 下 的 JSON 数据 。 
"val_1": 333.6515, 


"val_2": "\/Date(1534473729367 + 0800)\/", 
"val_3": 797001 


} 
实例 281 序列 化 数据 协定 时 忽略 某 个 成 员 
【导语 】 


有 时 候 并 不 需要 一 个 类 型 中 所 有 的 成 员 ( 属 性 与 字段 ) 都 参与 序列 化 ,要 阻止 某 个 成 员 
被 序列 化 ,需要 在 成 员 定义 上 应 用 IgnoreDataMemberAttribute。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Record 类 作为 数据 协定 , 稍 后 用 于 序列 化 。 

[DataContract(Namespace = "test—-rd-data", Name = "rd body")] 


Public class Record 
{ 


[DataMember(Name = "rd_ord")] 
public int RecordOrder { get; set; } 
[DataMember(Name = "rd title")] 


[人 
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public string RecordTitle { get; set; } 
[DataMenber(Name = "rd_ size")] 
public long SizeInBytes { get; set; } 
[IgnoreDataMember] 
public bool Tracked { get; set; } 

} 


在 序列 化 时 ,Tracked 属性 会 被 忽略 , 即 在 序列 化 后 生成 的 数据 中 不 会 包含 与 该 属性 有 
关 的 信息 。 
步骤 3: 执行 序列 化 。 


using(FileStrean fs = new FileStream("rd. xml", FileMode.Create)) 
{ 
Record rd = new Record 
{ 
RecordOrder = 1, 
RecordTitle = "Numbers", 
SizeInBytes = 12105 
Tracked = true 
}; 
DataContractSerializer szr = new DataContractSerializer(typeof(Record)); 
szr. WriteObject(fs, rd); 


} 
步骤 4: 执行 反 序 列 化 ,并 输出 反 序列 化 后 得 到 的 Record 实例 信息 。 


using(FileStrean fs = new FileStream("rd.xml", FileMode.Open)) 
{ 
DataContractSerializer sz = new DataContractSerializer(typeof (Record)); 
Record rd = sz.ReadObject(fs) as Record; 
// 输出 各 属性 的 值 
string msg = null; 
msg += $"{nameof(rd.RecordOrder)} = {rd.RecordOrder}\n"; 
msg += $ "{nameof(rd.RecordTitle)} = {rd.RecordTitle}\n"; 
msg += $"{nameof(rd.SizeInBytes)} = {rd.SizeInBytes} \n"; 
msg += $"{nameof(rd.Tracked)} = {rd.Tracked}"; 
Console. WriteLine(" 反 序列 化 得 到 的 Record 实例 :"); 
Console. Write(msg); 
} 


步骤 5: 运行 应 用 程序 ,控制 台 输 出 的 内 容 如 图 9-5 所 示 。 


图 9-5 反 序 列 化 得 到 的 Record 实例 
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Record 实例 序列 化 后 生成 的 XML 文档 如 下 。 


<rd body xmlns = "test— rd- data" xmlns:i="."> 
<rd ord>1</rd_ord> 
<rd_ size>12105 </rd_size> 
<rd title> Numbers </rd_title> 


</rd_body> 

从 生成 的 XML 文档 中 可 以 看 出 ,只 有 三 个 属性 被 序列 化 ,Tracked 属性 没有 参与 序 
列 化 。 

实例 282 ”改变 数据 协定 成 员 的 序列 化 顺序 

【导语 】 


- 般 会 按照 以 下 规则 来 序列 化 数据 协定 的 成 员 。 

生 类 的 成 员 。 

(2) 对 于 没有 设置 DataMemberAttribute. Order 属性 的 成 员 ,将 按照 字母 顺序 排序 。 

(3) 如 果 设 置 了 DataMemberAttribute. Order 属性 ,将 按照 该 顺序 进行 处 理 。 

(4) 如 果 设 置 了 DataMemberAttribute. Order 属性 ,但 是 有 多 个 成 员 的 Order 相同 , 那 
么 就 先 按 Order 属性 的 值 进行 排序 ,对 于 Order 属性 相同 的 成 员 则 按 字 母 顺 序 排 序 。 

【操作 流程 】 

步骤 1: 新建 控 制 台 应 用 程序 项 目 。 

步骤 2: 声明 Test 类 , 它 包 含 四 个 公共 属性 。 


[DataContract] 
public class Test 


{ 


[DataMenmber] 

public string PropD { get; set; } 
[DataMenber] 

public long PropC { get; set; } 
[DataMenmber] 

public int PropB { get; set; } 
[DataMenber] 

public short PropA { get; set; } 


} 
步骤 3: 对 Test 实例 进行 序列 化 。 


using(FileStrean fs = new FileStream("data.xml"，FileMode. Create) ) 
{ 
Test t = new Test 


{ 
PropR = 3, 
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PropB = 15, 
PropC 100000L, 
PropD = "abcde" 


上 


上 


}; 
DataContractSerializer sz = new DataContractSerializer(typeof(Test)); 
sz. WriteObject(fs, t); 

} 


步骤 4: 输出 序列 化 后 生成 的 XML 文档 。 


using(FileStrean fs = new FileStream("data. xml", FileMode. Open)) 
{ 

XDocument doc = XDocument.Load(fs); 

Console. Write("Test 实例 序列 化 后 生成 的 XML 文档 :\n" + doc); 
} 


XDocument 类 位 于 System. Xml. Ling 命名 空间 中 ,直接 调用 它 的 Load 静态 方法 就 可 
以 加 载 XML 文档 。XDocument 实例 在 转换 为 文本 时 会 自动 对 XML 文档 进行 缩 进 对 齐 。 
步骤 5: 此 时 运行 应 用 程序 ,控制 台 输出 的 XML 文档 如 下 。 


< Test “> 
<PropA>3</PropA> 
<PropB> 15 </PropB> 
<PropC > 100000 </PropC> 
< PropD > abcde </PropD> 
</Test> 


这 是 成 员 序列 化 的 默认 顺序 一 一 按照 字母 顺序 排列 。 
步骤 6: 回 到 Test 类 的 定义 代码 ,为 各 个 属性 设 曾 DataMemberAttribute. Order 属性 。 


[DataContract] 

public class Test 

{ 
[DataMenber(Order =- 2)] 
public string PropD { get; set; } 
[DataMenmber(Order = 0)] 
public long PropC { get; set; } 
[DataMember(Order = 1)] 
public int PropB { get; set; } 
[DataMenmber(Order = 3)] 
public short PropA { get; set; } 

} 


步骤 7: 再 次 运行 应 用 程序 ,这 次 生成 的 XML 文档 如 下 。 


< Test…> 
< EropC> 100000 </PropC> 
< PropB> 15 </PropB> 
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< PropD> abcde </PropD> 
<PropA> 3</PropA> 
</Test> 


因为 Order 属性 的 设置 ,数据 协定 成 员 的 序列 化 顺序 也 随 之 改变 ,此 时 Test 元 素 下 的 


子 元 素 顺 序 变 为 PropC 一 PropB>PropD>PropA.。 


实例 283 ”保留 实例 引用 
【导语 】 


开启 保留 实例 引用 选项 后 ,在 序列 化 的 时 候 会 为 每 个 实例 分 配 一 个 id, 以 保证 每 个 实例 
在 序列 化 时 只 生成 一 次 。 如 果 某 个 实例 被 多 个 成 员 引 用 ,那么 只 有 该 实例 第 一 次 出 现时 才 
会 填充 数据 ,随后 对 该 实例 的 引用 都 使 用 为 实例 所 分 配 的 id, 这 样 就 可 以 缩减 文档 的 长 度 。 


【操作 流程 】 
步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 


步骤 2: 声明 两 个 类 ,它们 都 是 数据 协定 ,并 且 OrderInfo 类 的 DetailsData 


OrderDetails 的 实例 。 


[DataContract] 

public class OrderDetails 

{ 
[DataMenber 
public string ContactName { get; set; } 
[DataMenmber 
public decimal Price { get; set; } 
[DataMenber 
public int Quantity { get; set; } 
[DataMenber 
public float Weight { get; set; } 


} 


[DataContract] 
public class OrderInfo 
{ 
[DataMenber] 
public int OrderNo { get; set; } 
[DataMenber] 
public DateTime BuildTime { get; set; } 
[DataMember] 
public OrderDetails DetailsData { get; set; } 


} 
步骤 3: 执行 序列 化 。 


using (FileStream fs = File.Open("data. xml", FileMode. Create) ) 
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OrderDetails dtl = new OrderDetails 
t 

ContactName = "Lee", 

Price = 3.15M, 

Quantity = 12, 

Weight = 17.5f 
}; 


OrderInfo[ ] ords = 


new OrderInfo 


{ 
OrderNo = 1, 
BuildTime = new DateTime(2018, 3, 27), 
DetailsData = dtl 


}, 
new OrderInfo 


长 
OrderNo = 2, 
BuildTime = new DateTime(2018, 9, 2), 
DetailsData = dtl 


}; 


DataContractSerializer sz = new DataContractSerializer(ords. GetType()); 
sz. WriteObject(fs, ords); 


} 


代码 首先 创建 OrderDetails 实例 ,然后 再 创建 OrderInfo 数组 ,数组 中 的 两 个 元 素 都 引 
用 OrderDetails。 
在 未 开启 引用 保留 选项 时 ,序列 化 后 得 到 的 XML 文档 如 下 。 


< ArrayOfOrderInfo …> 
< OrderInfo> 
< BuildTime> 2018 - 03 - 27T00:00:00 </BuildTine> 
< DetailsData> 
< ContactName > Lee </ContactName> 
< Price>3.15</Price> 
< Quantity> 12 </Quantity> 
<Weight>17.5 </Weight > 
</DetailsData> 
< OrderNo > 1 </OrderNo > 
</OrderInfo> 
<OrderInfo> 
<BuildTime > 2018 - 09 - 02T00:00:00 </BuildTine> 
<DetailsData> 
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< ContactName > Lee </ContactName> 
<Price> 3.15</Price> 
< Quantity> 12 </Quantity> 
<Weight >17.5 </Weight > 
</DetailsData> 
< OrderNo > 2 </OrderNo > 
</OrderInfo> 
</ArrayOfOrderInfo> 


可 以 看 到 ,OrderDetails 实例 的 各 个 属性 值 被 写 人 了 两 次 。 
步骤 4: 对 序列 化 的 代码 进行 修改 ,开启 保留 引用 选项 。 


using (FileStream fs = File.Open("data. xml", FileMode. Create) ) 
{ 


DataContractSerializerSettings settings = new DataContractSerializerSettings(); 

settings. PreserveObjectReferences = true; 

DataContractSerializer sz = new DataContractSerializer(ords. GetType(), settings); 

sz. WriteObject(fs, ords); 
} 


先 要 实例 化 一 个 DataContractSerializerSettings 对 象 ,然后 将 它 的 PreserveObjectReferences 
属性 设置 为 true, 保 留 引用 选项 就 被 启用 了 ,最 后 再 将 DataContractSerializerSettings 对 象 


传递 给 DataContractSerializer 类 的 构造 函数 。 
步骤 5: 运行 应 用 程序 ,保留 对 象 引 用 后 生成 的 XML 文档 如 下 。 


< ArrayOfOrderInfo z:Id= "1" z:Size= "2" .> 
< OrderInfo z:Id= "2"> 
<BuildTime > 2018 - 03 - 27T00:00:00 </BuildTine> 
<DetailsData z:Id= "3"> 
< ContactName z:Id= "4"> Lee</ContactName > 
<Price>3.15 </Price> 
< Quantity> 12 </Quantity> 
<Weight >17.5</Weight > 
</DetailsData> 
< OrderNo > 1 </OrderNo > 
</OrderInfo> 
< OrderInfo z:Id= "5"> 
<BuildTime> 2018 - 09 - 02T00:00:00 </BuildTine> 
<DetailsData z:Ref= "3" i:nil = "true" /> 
< OrderNo> 2 </OrderNo> 
</OrderInfo> 
</ArrayOfOrderInfo> 


此 次 OrderDetails 实例 的 各 个 属 
XML 文档 中 的 z: Ref 二 "3"。 


性 值 只 写 入 了 一 次 ,第 二 次 是 通过 id 引用 的 , 即 上 述 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。 线程 ; 

。 并 行 任务 ; 

， 异步 等 待 语法 。 


10.1 线程 


实例 284 ”Sleep 方法 的 妙用 


【导语 】 

Sleep 是 Thread 类 的 静态 方法 ,调用 该 方法 的 线程 ( 即 当 前 线程 ) 会 暂停 指定 的 时 间 。 
到 达 指 定 的 时 间 后 ,线程 重新 被 “唤醒 "。 在 异步 编程 中 ,可 以 使 用 Sleep 方法 来 等 待 其 他 线 
程 完成 某 项 操作 ,但 是 Sleep 方法 不 能 准确 知道 其 他 线程 所 处 理 的 事件 在 什么 时 间 完 成 , 因 
此 Sleep 方法 仅 适用 于 线程 间 不 需要 精确 同步 的 场合 。 若 需要 精确 同步 ,推荐 使 用 等 待 句 
柄 ,例如 AutoResetEvent 类 。 

Sleep 方法 有 以 下 两 个 重 载 。 


(1) static void Sleep(int millisecondsTimeout); 
该 重 载 接收 一 个 int 类 型 的 参数 ,表示 线程 暂停 的 毫秒 数 。 

(2) static void Sleep(TimeSpan timeout); 

该 重 载 可 以 指定 具体 的 时 间 ,TimeSpan 类 型 的 参数 可 以 设 定 精度 更 高 的 时 间 段 。 
【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Main 方法 中 输入 以 下 代码 。 


Console. WriteLine(" 这 是 第 一 行文 本 ,3 秒 后 输出 第 二 行文 本 。"); 
Thread. Sleep( 3000); 
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Console. WriteLine(" 这 是 第 二 行文 本 ,5 秒 后 输出 第 三 行文 本 。"); 
Thread. Sleep( 5000); 
Console. WriteLine(" 这 是 第 三 行文 本 。"); 


上 述 代 码 会 在 控制 台 上 输出 三 行文 本 。 输出 第 一 二 行文 本 之 间 调 用 Sleep 方法 ,使 当 


前 线程 暂停 3 秒 ; 输出 第 二 三 行文 本 之 间 调 用 Sleep 方法 ,使 当前 线程 暂停 5 秒 。 
步骤 3: 运行 应 用 程序 .输出 结果 如 图 10-1 所 示 。 


图 10-1 Sleep 方法 应 用 示例 


实例 285 ”创建 新 线程 


【导语 】 

要 在 应 用 程序 中 创建 新 线程 , 先 实例 化 Thread 类 ,然后 设置 好 相关 的 属性 (例如 
IsBackground 属性 ) ,再 调用 Start 实例 方法 即 可 启动 新 线程 。 

调用 Thread 类 构造 函数 时 需要 传递 一 个 委托 对 象 ,该 委托 对 象 关联 要 在 新 线程 上 执 
行 的 代码 。Thread 类 构造 函数 接收 以 下 两 种 委托 对 象 。 

第 一 种 是 不 带 参 数 的 , 它 适用 于 无 须 向 新 线程 传递 数据 的 代码 。 格 式 如 下 。 


delegate void Threadstart(); 

男 一 种 委托 对 象 带 有 一 个 object 类 型 的 参数 ,可 以 将 要 传递 给 新 线程 的 数据 赋值 给 obj 
参数 ,由 于 参数 声明 为 object 类 型 ,因此 它 可 以 接收 各 种 类 型 的 数据 。 格式 如 下 。 

delegate void ParameterizedThreadStart(object obj); 


对 于 不 需要 传递 参数 的 新 线程 ,直接 调用 Thread 实例 无 参数 版 本 的 Start 方法 启动 ; 
而 对 于 有 数据 要 传递 的 线程 , 则 应 该 调用 以 下 重 载 版 本 的 Start 方法 。 


void Start(object parameter); 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 创建 Thread 实例 。 


Thread th = new Thread(() => 

{ 
Console. ForegroundColor = ConsoleColor. Green; 
Console. WriteLine( $ "正在 {Thread. CurrentThread. Name} 线程 上 执行 :"); 
for(int i = 0; i<5; i++) 
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Console. Write(i + 1 + " "); 
Thread. Sleep(800); 

$ 

Console. Write("\n\n"); 

Console. ResetColor(); 


D; 

在 新 线程 上 执行 代码 时 ,每 通过 一 轮 for 循环 都 调用 一 次 Sleep 方法 让 新 线程 暂停 一 
下 ,可 以 模拟 耗 时 任务 的 情形 。 

步骤 3: 通过 Name 属性 为 新 线程 分 配 一 个 名 称 。 


th. Name = "new thread" 
步骤 4: 调用 Start 方法 ,启动 线程 。 


th. Start(); 


步骤 5: 运行 应 用 程序 项 目 ,输出 结果 如 图 10-2 所 示 。 ”图 10-2 在 新 线程 上 执行 代码 


实例 286 ”启动 新 线程 并 传递 参数 


【导语 】 

实例 化 Thread 类 时 ,调用 带 ParameterizedThreadStart 委托 类 型 参数 的 构造 函数 , 传 
递 给 新 线程 的 参数 最 终 会 传播 到 ParameterizedThreadStart 委托 所 关联 的 方法 上 ,方法 内 
部 的 代码 可 以 从 方法 参数 获得 被 传递 到 新 线程 的 数据 。 由 于 ParameterizedThreadStart 委 
托 只 接收 单个 参数 ,如 果 考 虑 向 新 线程 传递 多 个 对 象 实例 ,就 得 先 将 这 些 对 象 包装 为 单个 对 
象 ,例如 数组 、 元 组 ,或 者 自 定义 封装 的 类 型 。 

本 实例 将 演示 在 新 线程 中 向 文件 写 人 文本 ,在 主线 程 中 将 文件 名 通过 参数 传递 给 新 
线程 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 字符 串 类 型 的 变量 ,表示 文件 名 。 


string file name = "test.txt"; 


步骤 3: 创建 新 的 Thread 实例 ,注意 构造 函数 中 使 用 的 是 ParameterizedThreadStart 
委托 ( 带 一 个 object 类 型 的 参数 )。 


Thread newThread = new Thread(p => 

{ 
string fileName = pas string; 
using (Filestream fs = newFileStream(fileNane, FileMode. Create)) 
{ 


using (StreamWriter writer = new StreamWriter(fs)) 
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{ 
// 写 入 文本 
writer. NriteLine(" 空 山 新 雨 后 "); 
writer. WriteLine(" 天 气 晚 来 秋 "); 
writer. WriteLine(" 明 月 松 间 照 "); 
writer, WriteLine( "清泉 石 上 流 "); 
} 


: 
D; 


注意 : 参数 是 object 类 型 ,在 提取 参数 时 要 注意 类 型 转换 。 字 符 囊 属于 引用 类 型 ,所 以 此 处 
可 以 通过 as 关键 字 进 行 引 用 转换 。 


步骤 4: 启动 新 线程 ,并 把 文件 名 传递 给 新 线程 。 
newThread. Start(file_name) ; 


真正 向 新 线程 传递 数据 的 是 在 调用 Start 方法 的 时 候 。 
步骤 5: 调用 Join 方 法 ,阻止 主线 程 ,等 待 新 线程 执行 完成 再 继续 。 


newThread. Join(); 


步骤 6: 运行 应 用 程序 后 ,在 程序 所 在 目录 下 会 找到 test. txt 文件 。 
实例 287 ”等待 线 程 信号 一 一 ManualResetEvent 


【导语 】 

抽象 类 WaitHandle 规范 了 线程 之 间 发 送 与 等 待 事件 信号 的 行为 逻辑 。 

线程 之 间 所 执行 的 代码 往往 是 相互 独立 的 ,在 某 些 有 特殊 要 求 的 场合 ,会 使 得 代码 人 逻辑 
不 可 控 。 例 如 ,A、B 两 个 线程 分 别 进行 运算 ,但 是 B 线程 的 运算 开始 之 前 必须 保证 A 线程 
的 运算 已 经 完成 ,这 种 情况 下 ,就 需要 线程 同步 了 。 

线程 同步 的 一 种 解决 方案 就 是 发 送信 号 与 等 待 信号 。 例 如 上 述 例子 ,可 以 在 线程 之 间 
共享 一 个 事件 句柄 ,B 线程 调用 WaitOne 方法 后 会 被 阻止 ,然后 等 待 A 线程 发 送信 号 ; A 
线程 在 完成 其 计算 后 发 出 信号 ,B 线程 收 到 信号 后 才 会 继续 执行 ,这 样 就 可 以 确保 先 执 行 A 
线程 的 代码 ,再 执行 B 线程 的 代码 。 

ManualResetEvent 类 是 事件 等 待 句柄 的 一 个 实现 版 本 , 它 的 特点 是 一 一 发 出 事件 信号 
(调用 Set 方法 ) 之 后 会 一 直 保持 有 信号 状态 ,此 时 所 有 处 于 等 待 中 的 线程 都 会 继续 执行 。 
要 把 事件 句柄 切换 回 无 信号 状态 ,必须 手动 调用 Reset 方法 。 也 就 是 说 ,ManualResetEvent 
对 象 需要 手动 切换 信号 状态 ,如 果 调 用 Set 方法 之 后 忘记 调用 Reset 方法 ,那么 该 事件 句柄 
就 会 一 直 处 于 有 信号 状态 ,所 有 被 阻止 的 线程 都 会 释放 并 继续 执行 。 

本 实例 演示 了 如 何在 新 的 线程 上 计算 从 1 到 100 的 累加 运算 , 即 计算 1 十 2 十 3 十 …… 十 
100 的 总 和 。 主 线程 必须 等 待 新 线程 计算 完毕 后 才能 继续 ,虽然 主线 程 可 以 调用 Sleep 方法 
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来 暂停 一 段 时 间 , 但 是 要 暂停 的 时 间 是 不 可 预知 的 ,因此 本 实例 使 用 事件 等 待 句柄 的 效果 
较 好 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 项 目 模板 创建 的 Program 类 中 声明 一 个 ManualResetEvent 类 型 的 私有 字 
段 ,为 了 可 以 在 Main 方法 中 直接 访问 ,字段 可 以 声明 为 静态 字段 。 


static ManualResetEvent mnlEvt = new ManualResetEvent(false); 


注意 : ManualResetEvent 类 的 构造 函数 包含 一 个 bool 类 型 的 参数 ,用 来 标识 事件 句柄 在 创 
建 时 的 初始 状态 一 一 有 信号 还 是 无 信号 。 本 实例 中 ,主线 程 需要 等 待 另 一 个 线程 计 
算 完成 才能 继续 ,因此 ManualResetEvent 对 象 的 初始 状态 应 该 为 无 信号 ,否则 主线 
程 是 不 会 等 待 的 。 将 参数 设置 为 false 表示 初始 状态 为 无 信号 。 


步骤 3: 创建 新 线程 。 


Thread th = new Thread(() => 
{ 


intn = 1 
int result = 0; 
while(n <= 100) 
{ 
// 延 时 模拟 
Thread. Sleep(20); 
result += n; 
ntt+; 
} 
Console. WriteLine(" 计 算 结 果 :{0}"，result); 
mlEvt. Set(); 
// 发 送信 号 后 又 马上 切换 为 无 信号 状态 
mnlEvt. Reset() 7 
]) 


上 述 代码 中 ,完成 计算 后 需要 调用 Set 方法 ,因为 这 样 主线 程 才 能 收 到 信号 ,随后 可 以 
调用 Reset 方法 来 恢复 到 无 信号 状态 。 在 本 例 中 ,Reset 方法 的 调用 是 可 选 的 ,因为 具有 一 
个 主线 程 在 等 待 ,并 没有 其 他 线程 被 阻止 ,就 算 不 调用 Reset 方法 也 不 会 影响 线程 同步 。 

步骤 4: 在 主线 程 的 代码 中 ,必须 调用 WaitOne 方法 ,否则 主线 程 是 不 会 进入 等 待 状 
态 的 。 


Console. WriteLine(" 正 在 等 待 线程 计算 …… “Ye 
mnlEvt. WaitOne( ); 
Console. WriteLine(" 计 算 完 毕 !"); 
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步骤 5: 运行 应 用 程序 ,控制 台 输 出 结果 如 图 10-3 所 示 。 请 读者 重点 观察 各 行文 本 的 
输出 顺序 。 


图 10-3 ”等待 新 线程 完成 累加 运算 


实例 288 ”等 待 线 程 信号 

【导语 】 

与 ManualResetEvent 类 不 同 ,AutoResetEvent 类 在 调用 Set 方法 发 出 信号 之 后 ,会 立 
刻 恢 复 为 无 信号 状态 ,不 需要 调用 Reset 方法 。 

本 实例 假设 某 个 任务 将 分 为 三 个 阶段 执行 ,而 且 顺 序 不 能 颠倒 ,第 一 阶段 完成 后 再 执行 
第 二 阶段 ,第 二 阶段 完成 后 再 执行 第 三 阶段 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Program 类 中 声明 三 个 AutoResetEvent 类 型 的 私有 字段 ,为 了 便于 在 Main 
方法 中 访问 ,需要 声明 为 静态 字段 。 


AutoResetEvent 


static RutoResetEvent evtl = new AutoResetEvent(false); 
static AutoResetEvent evt2 = new AutoResetEvent (false); 


static AutoResetEvent evt3 = new AutoResetEvent(false); 

这 三 个 字段 分 别 用 于 发 送 实例 任务 中 三 个 阶段 处 理 完成 的 信号 。 

步骤 3: 创建 三 个 线程 ,假设 它们 分 别 代表 任务 中 的 三 个 阶段 ,具体 参考 代码 清单 10-1。 
代码 清单 10-1 三 个 新 线程 


Thread thl = new Thread(() => 
{ 
Console. WriteLine(" 正 在 进行 第 一 阶段 ……"); 
Thread. Sleep(2000); 
Console. WriteLine(" 第 一 阶段 处 理 完成 !") ; 
// 发 送信 号 
evt1. Set(); 
DD); 
Thread th2 = new Thread(() => 
{ 
// 等 待 第 一 阶段 完成 
evtl. WaitOne( ); 
Console. WriteLine(" 正 在 进行 第 二 阶段 ……"); 
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Thread. Sleep(2000); 
Console. WriteLine(" 第 二 阶段 处 理 完成 1"); 
// 发 出 信号 
evt2. Set() 
D); 
Thread th3 = new Thread(() => 
{ 
// 等 待 第 二 阶段 完成 
evt2. WaitOne(); 
Console. WriteLine(" 正 在 进行 第 三 阶段 ……"); 
Thread. Sleep(2000); 
Console. WriteLine(" 第 三 阶段 处 理 完成 1"); 
// 发 送信 号 
evt3. Set(); 


D); 


发 送 


个 


是 通 
顺序 


步骤 4: 依次 启动 三 个 线程 。 


th1. Start(); 
th2. Start( ); 
th3. Start(); 


步骤 5: 主线 程 等 待 最 后 一 个 阶段 完成 ( 即 收 到 evt3 
的 信和 号) 才能 继续 执行 。 


evt3. WaitOne( ); 图 10-4 等待 三 个 事件 句柄 的 信号 
Console. WriteLine("\n 已 完成 所 有 操作 。"); 


步骤 6: 运行 应 用 程序 ,输出 结果 如 图 10-4 所 示 。 
实例 289 ”多 个 线程 同时 写 一 个 文件 


【导语 】 

作为 公共 基 类 ,WaitHandle 类 公开 了 三 个 比较 实用 的 静态 方法 : 

(1) WaitAny: 调用 此 方法 后 ,当前 线程 将 被 阻止 。 如 果 指 定 的 事件 句柄 数组 中 有 任意 
事件 发 出 信号 , 则 此 方法 将 返回 数组 中 发 出 信号 的 事件 句柄 的 索引 ,并 结束 等 待 。 

(2) WaitAll: 在 指定 的 事件 句柄 数组 中 ,必须 当 所 有 事件 句柄 都 发 出 信号 后 , 才 会 结束 


(3) SignalAndWait: 可 以 直接 切换 两 个 事件 句柄 的 状态 。 

本 实例 演示 了 WaitAll 方法 的 使 用 。 实 例 的 任务 是 把 9 字 节 写 人 到 文件 中 ,这 个 过 程 
过 3 个 线程 来 完成 的 ,并 且 这 些 线程 的 执行 是 无 序 的 。 为 了 保证 9 字 节 能 按照 原 有 的 
写 入 ,可 以 将 这 些 字 节 序列 进行 “分 段 ”, 即 : 第 1 个 线程 写 人 第 1.2、3 字 节 , 第 2 个 线 
和 第 4.5、6 字 节 ,第 3 个 线程 写 人 第 7.8、9 字 节 。 每 个 线程 只 负责 写 自己 该 写 入 的 位 
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置 , 就 算 3 个 线程 是 无 序 执行 的 ,最 终 也 不 会 破坏 原 有 字 节 的 顺序 。 各 个 线程 对 应 着 一 个 事 
件 句柄 (本 实例 使 用 AutoResetEvent 类 ) ,只 要 线程 完成 自己 该 做 的 任务 后 ,就 通过 对 应 
的 事件 句柄 发 出 信号 。 主 线程 将 通过 WaitHandle 类 的 WaitAll 方 法 等 待 所 有 线程 执行 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Program 类 中 声明 两 个 只 读 的 字段 ,为 了 便于 在 Main 方法 中 访问 ,可 以 声 
明 为 静态 字段 。 这 两 个 字段 分 别 是 要 输出 的 文件 名 和 一 个 字 节 数组 (包含 要 写 进 文件 的 
9 字 节 3 


// 文件 名 

static readonly string FileName = "demoFile. data"; 
// 要 写 人 文件 的 9 字 节 

static readonly byte[ ] orgBuffer = 

{ 


0x0C, 0x10, Ox02, 
OxE3, Ox71, OxA2, 
0x13, 0xB8, 0x06 
}; 


步骤 3: 在 Program 类 中 声明 一 个 静态 字段 一 一 AutoResetEvent 数组 , 它 将 包含 3 个 
元 素 , 可 以 作为 与 执行 线程 相对 应 的 事件 句柄 。 


static RutoResetEvent[ ] writtenEvents = { 
new AutoResetEvent(false), 
new AutoResetEvent(false), 
new RutoResetEvent(false) 


}; 
步骤 4: 启动 3 个 新 线程 ,每 个 线程 负责 写 3 字 节 ， 


for (intn = 0; n<3; nt+) 
{ 
Thread th = new Thread((p) => 
{ 
// 先 把 要 写 的 字 节 复制 出 来 
int currentCount = Convert.ToInt32(p); 
int copyIndex = currentCount >x 3; 
byte[ ] tmpBuffer = new byte[3]; 
Array. Copy( orgBuffer, copyIndex, tmpBuffer, 0, 3); 
// 打开 文件 流 
using (FileStream fs = new Filestream(FileName, FileMode. OpenOrCreate, FileAccess. 
Write, FileShare. Write)) 
{ 
// 定位 流 的 当前 位 置 
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fs.Seek(copyIndex, SeekOrigin. Begin); 
// 写 人 数据 
fs.Write(tmpBuffer, 0, tmpBuffer. Length); 
} 
// 发 出 信号 
writtenEvents[currentCount]. Set( ); 
DD); 
// 标识 为 后 台 线程 
th. IsBackground = true; 
// 启动 线程 
th. Start(n); 


注意 : 由 于 有 多 个 线程 同时 写 入 一 个 文件 ,因此 在 创建 FileStream 实例 时 ,必须 指定 一 个 有 
效 的 FileShare 枚 举 值 ,本 例 中 应 为 Write。 指 定 此 参数 的 目的 是 允许 多 个 线程 同时 
写 一 个 文件 ,否则 会 发 生 错误 。 


步骤 5: 在 主线 程 中 ,调用 WaitAll 方法 等 待 所 有 事件 句柄 发 出 的 信号 。 传 递 给 方法 的 
参数 就 是 前 面 声 明 的 AutoResetEvent 数组 。 


Console. WriteLine( "等 待 所 有 线程 完成 文件 写 人 …… ys 
WaitHandle. WaitAll (writtenEvents); 
Console. WriteLine( "文件 写 人 完成 。"); 


步骤 6: 为 了 验证 9 字 节 是 否 正 确 地 写 入 文件 ,在 写 入 完成 后 再 读 出 文件 中 的 字 节 。 


using (FileStream fsin = new FileStream(FileName, FileMode. Open)) 

byte[ ] buffer = new byte[fsin.Length]; 

fsin. Read(buffer，0，buffer. Length); 

Console. WriteLine( $ "从 文件 读 出 来 的 字 节 :\n{BitConverter. ToString(buffer)}"); 
} 


步骤 7: 运行 应 用 程序 ,控制 台中 输出 的 内 容 如 图 10-5 所 示 。 


图 10-5 多 个 线程 同时 写 一 个 文件 


可 以 对 比 两 次 输出 的 字 节 数组 ,如果 相 同 ,说 明 3 个 线程 已 把 字 节 序列 正确 地 写 入 
文件 ; 
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实例 290 ”使 用 线程 锁 


【导语 】 

当 多 个 线程 访问 同一 个 对 象 时 ,由 于 线程 之 间 抢 占 资源 ,会 使 数据 状态 不 同步 ,从 而 导 
致意 外 发 生 。 非 常 经 典 的 一 个 案例 就 是 “ 卖 火车 票 ”, 假 设 有 50 张 火车 票 ,有 5 个 线程 同时 
售票 (类 似 于 5 个 售票 窗口 同时 工作 ) ,并且 各 个 线程 之 间 都 会 抢夺 处 理 器 时 间 片 ,线程 A 
判断 还 剩余 1 张 火车 票 并 正 准 备 售 出 最 后 一 张 票 ,此 时 意外 发 生 , 由 于 在 线程 A 判断 剩余 
票数 与 执行 售票 之 间 存 在 时 间 差 ,而 正好 在 这 段 时 间 里 线程 B 把 最 后 一 张 火车 票 卖 完 了 
造成 线程 A 在 执行 售票 时 竞 发 现 无 票 可 售 。 

这 种 看 似 不 符合 逻辑 的 事情 ,在 异步 编程 中 却 很 容易 遇 到 。 有 时 代码 出 现 错误 后 ,开发 
人 员 不管 怎 么 调试 ,始终 找 不 到 出 错 的 原因 ,这 很 有 可 能 是 忽略 了 异步 操作 中 资源 同步 的 问 
题 。 为 了 避免 关键 的 数据 被 线程 意外 修改 而 引发 错误 ,对 于 被 多 个 线程 访问 的 资源 ,应 当 使 
用 必 各 铅 。 当 某 个 线程 即将 使 用 资源 时 , 先 对 资源 上 锁 , 上 锁 之 后 其 他 线程 将 无 法 使 用 该 资 

源 , 只 能 等 到 该 线程 对 资源 解锁 后 才能 访问 。 线 程 锁 可 以 保证 在 同一 时 刻 只 有 一 个 线程 能 
访问 资源 。 在 C# 语言 中 ,可 以 直接 用 lock 语句 块 来 锁定 资源 ; 在 Visual Basic 请 言 中 ,可 
以 使 用 SyncLock 语句 块 来 给 资源 上 锁 ; 在 . NET 框架 中 则 是 以 Monitor 类 来 实现 线程 锁 
的 ,调用 Enter 方法 锁定 资源 ,随后 调用 Exit 方法 解锁 资源 。 

本 实例 演示 了 通过 4 个 线程 来 从 List 实例 中 删除 元 素 。 当 List 实例 的 Count 属性 为 0 
时 ,就 应 该 停止 删除 操作 (因为 List 实例 中 已 经 没有 元 素 了 ) ,代码 每 次 只 删除 一 个 元 素 , 所 
以 在 删除 元 素 之 前 部 要 检查 一 下 Count 属性 是 否 为 0。 当 Count 属性 为 1 时 ( 剩 下 最 后 一 
个 元 素 ) 就 容易 出 现 意外 ,因为 如 果 某 线程 经 过 判断 确定 Count 属性 不 为 0, 但 在 这 个 线程 
执行 删除 元 素 之 前 ,其 他 线程 可 能 意外 地 把 最 后 一 个 元 素 删除 了 ,这 时 候 该 线程 再 执行 删除 
就 会 发 生 错误 。 

这 种 情况 就 需要 线程 锁 了 ,每 一 轮 删除 操作 中 ,从 判断 Count 属性 到 执行 删除 这 个 过 
程 ,当前 线程 都 应 该 将 List 实例 锁定 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Program 类 中 声明 一 个 静态 字段 ,类 型 为 List< int >, 并 为 其 初始 化 。 


static List< int> intList = new List< int>() 

{ 
100, 105, 108, 113, 265, 970, 160, 
410, 303, 302, 104, 103, 102, 921, 
500, 501, 521, 522, 210, 211, 212, 
213, 214, 175, 174, 376 

}; 


步骤 3: 在 Main 方法 中 ,启动 4 个 新 线程 ,对 List 对 象 执行 RemoveAt 方法 删除 一 个 
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for (int i = 0; i<4; it+) 

{ 
Thread th = new Thread(() => 
{ 


while (true) 


{ 
if (intList.Count == 0) 
break; 
Thread. Sleep(15); 
intList. RemoveAt(0); 
Console. WriteLine( $ "列表 中 剩余 元 素 { intList. Count} 个 "); 
} 
D); 
th. Start(); 
} 
步骤 4: 由 于 多 个 线程 共同 访问 的 资源 (此 处 是 List 对 象 ) 没 有 上 锁 , 运 行 应 用 程序 就 


会 收 到 如 图 10-6 所 示 的 异常 信息 ,这 正 是 由 于 最 后 一 个 元 素 被 意外 删除 了 。 


用 户 未 处 理 的 异常 HX 


System_ArgumentOutOfRangeException:"Index was out of 
range. Must be non-negative and less than the size of the 
collection.” 


?异常 设置 


图 10-6 删除 元 素 时 发 生 异 常 
步骤 5: 此 时 要 对 代码 进行 修改 ,加 上 lock 语句 块 。 
for (int i = 0; i<4; it+) 


{ 
Thread th = new Thread(() => 


{ 
while (true) 
{ 
lock (intList) 
{ 
if (intList. Count == 0) 
break; 
Thread. Sleep(15); 
intList. RemoveAt(0); 
Console. WriteLine( $ "列表 中 剩余 元 素 {intList. Count} 个 "); 
} 
上 
D); 
th. Start(); 
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步骤 6: 再 次 运行 应 用 程序 ,就 不 会 收 到 异常 信息 了 ,执行 结果 如 图 10-7 所 示 。 


图 10-7 List 对 象 中 的 元 素 可 以 正确 地 被 删除 了 


10.2 并 行 任务 


实例 291 


【导语 】 


六 
说 ,使 


用 Task 更 优 拉 


启动 Task 的 三 种 方法 


fF 行 任务 能 够 充分 利用 多 核 处 理 器 的 资源 ,而 且 由 框架 底层 自动 调配 。 从 综合 性 能 上 


F Thread。 执 行 新 Task 的 方法 与 Thread 相似 ,也 是 通过 委托 类 型 来 封 


装 要 运行 的 代码 。 本 实例 演示 了 启动 新 Task 的 三 种 方法 。 
【操作 流程 】 
步骤 1: 新 建 控制 台 应 用 程序 项 目 。 
步骤 2: 第 一 种 方法 ,实例 化 Task 类 ,然后 调用 Start 方法 。 


Task taskl = new Task(() => 


{ 


Console. WriteLine(" 任 务 1 已 执行 。"); 


D; 

// 启动 任务 
task1. Start() 
task1. Wait() 
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Wait 方法 的 作用 是 在 当前 线程 上 等 待 该 Task 执行 完成 。 
步骤 3: 第 二 种 方法 ,直接 调用 Task 类 的 Run 静态 方法 。 


Task task2 = Task.Run(() => 
{ 
Console. WriteLine(" 任 务 2 已 执行 。"); 
DD; 
task2. Wait(); 


成 功 调用 Run 方法 后 会 返回 一 个 Task 实例 , 它 表示 已 启动 的 并 行 任务 。 
步骤 4: 第 三 种 方法 ,通过 TaskFactory 类 来 创建 新 Task。 


TaskFactory factory = new TaskFactory(); 
Task task3 = factory.StartNew(()=> 
t 

Console. WriteLine(" 任 务 3 已 执行 。"); 
DD; 
task3. Wait (); 


实例 292” 带 返回 值 的 Task 


【导语 】 

本 实例 演示 了 使 用 并 行 任务 计算 5 的 阶乘 ( 即 1X2X3X4X5) ,并 获取 计算 结果 。 
【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 调用 Task 类 的 Run 方法 启动 新 任务 ,并 在 执行 的 委托 中 ,将 计算 结果 返回 。 


var task = Task.Run(() => 
{ 
longr = 1L; 
jn 
while(t <= 5) 
{ 
1 
bd 
} 
return r; 


DD; 


由 于 并 行 任务 有 返回 值 , Run 方法 会 根据 return 语句 推断 出 返回 类 型 为 Task 
<long>。 


步骤 3: 等 待 任务 完成 ,然后 获得 计算 结果 。 


task. Wait( ); 
long result = task.Result; 
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步骤 4: 运行 应 用 程序 ,控制 台 输 出 的 内 容 如 下 。 


5 的 阶乘 :120 
实例 293 ”传递 状态 数据 
【导语 】 


在 启动 新 Task 时 ,可 以 传递 一 个 object 类 型 的 对 象 实例 作为 状态 数据 (可 以 认为 是 输 
入 参数 ) 。 由 于 所 需 类 型 是 object, 因 此 可 以 传递 各 种 数据 类 型 。 

本 实例 将 演示 将 二 元 组 实例 传递 给 新 的 Task ,并 在 并 行 代码 中 读 出 其 中 的 数据 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 二 元 组 ,其 中 包含 string 和 int 类 型 的 值 。 


var state = (Nane: "Jack", Age: 28); 
步骤 3: 创建 Task 实例 ,将 上 述 二 元 组 作为 状态 数据 传递 。 


Task t = new Task(s => 
{ 
// 读 取 状态 数据 
(string name, int age) = ((string, int))s; 
Console. WriteLine( $ "Name: {name}\nAge: {age}"); 
}, state); 


以 下 重 载 版 本 的 构造 函数 支持 输入 状态 数据 : 
public Task(Action < object > action, object state); 

其 中 ,由 于 要 在 执行 代码 中 接收 状态 数据 ,所 以 需要 使 用 一 个 带 object 类 型 参数 的 委托 
步骤 4: 启动 并 行 任务 ,然后 等 待 其 完成 。 


t. Start(}s 
t. Wait( ); 


步骤 5: 运行 应 用 程序 ,从 状态 数据 中 读 到 的 内 容 如 下 。 


Name: Jack 
Age: 28 


实例 294 ”串联 并 行 任务 


【导语 】 
在 一 些 复 杂 的 处 理 逻 辑 中 ,经 常会 执行 多 个 并 行 任务 ,并 且 这 些 任 务 都 需要 按照 一 定 的 
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顺序 执行 ,在 这 种 情况 下 ,把 并 行 任务 进行 串联 比 等 待 事件 句柄 信号 更 简单 。 

Task 类 公开 ContinueWith 实例 方法 ,调用 该 方法 后 ,会 将 当前 任务 与 下 一 个 要 执行 的 
任务 串联 ,当前 任务 执行 完成 后 就 会 启动 下 一 个 任务 。ContinueWith 方法 返回 Task 实例 ， 
即 串 联 执行 的 新 任务 ,并 且 ContinueWith 方法 可 以 连续 调用 ,例如 以 下 方式 。 


myTask. ContinueWith( … ) 
.ContinueWith( *… ) 
.ContinueWith( *… ) 


本 实例 将 演示 通过 三 个 Task 进行 加 法 运算 ,第 一 个 Task 返回 整数 值 10, 第 二 个 Task 
在 第 一 个 Task 返回 值 的 基础 上 再 加 上 15 并 返回 ,第 三 个 Task 在 第 二 个 Task 所 返回 的 结 
果 上 再 加 上 20 并 返回 计算 结果 。 这 三 个 Task 必须 按照 顺序 执行 ,因此 应 该 调用 
ContinueWith 方法 进行 串联 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 串联 执行 三 个 并 行 任务 ,最终 返回 给 task 变量 的 是 最 后 执行 的 Task 所 返回 的 
结果 。 


Task< int> task = Task.Run(() =>10) // 返 回 10 
.ContinueWith(lasttask => lasttask.Result + 15) // 返回 25 
.ContinueWith(lasttask => lasttask. Result + 20); // 返回 45 


步骤 3: 等 待 并 行 任务 完成 。 

task. Wait( ); 

步骤 4: 运行 应 用 程序 ,最 后 的 输出 结果 如 下 。 
计算 结果 :45 


实例 295 ”使 用 Parallel 类 执行 并 行 操作 


【导语 】 

Parallel 类 是 一 个 轻 量 级 的 并 行 操作 执行 类 ,主要 用 在 基于 for 或 foreach 循环 的 并 行 
代码 上 ,该 类 会 充分 调配 处 理 器 的 资源 来 运行 循环 ,提升 性 能 。 

本 实例 将 使 用 Parallel 类 启动 并 行 的 foreach 循环 来 向 文件 写 数据 ,每 一 轮 循 环 负责 写 


全 交 侍 : 
【操作 流程 】 
步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 创建 一 个 字符 串 数 组 实例 ,包含 要 创建 的 文件 名 列表 。 


string[ ] fileNanmes = 
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"demo 1 dx", "demo 2_dx", "demo 3_dx", "demo 4_ dx", 
"demo_5_dx", "demo_6_dx", "demo 7_dx", "demo_8_dx" 
B; 


步骤 3: 调用 Parallel. ForEach 方法 循环 写 文 件 ,文件 长 度 以 及 字 节 序列 均 随 机 产生 。 


Random rand = new Random(); 
Parallel. ForEach(fileNames, (fn) => 
{ 
int len; 
byte[ ] data; 
lock (rand) 
‘ 
// 随机 产生 文件 长 度 
len = rand. Next(100, 90000); 
data = new byte[ len]; 
// 生成 随机 字 节 序列 
rand. NextBytes (data); 
} 
using(FileStream fs = newFileStream(fn, FileMode. Create)) 
{ 
fs. Write(data); 
} 
Console. WriteLine( $ "已 向 文件 {fn} 写 和 人 {data. Length} 字 节 "); 
D; 


步骤 4: 运行 应 用 程序 ,执行 结果 如 图 10-8 所 示 。 


已 癌 》 
已 向 3 
已 向 
已 向 
已 向: 
已 向 
已 向 
区 


图 10-8 ”并 行 写 文件 


10.3 异步 等 待 语法 


实例 296 ”者 明 异 步 方法 

【导语 】 

异步 等 待 语法 主要 由 一 对 语言 关键 字 组 成 : async 和 await, 这 两 个 关键 字 通 常 是 成 对 
出 现 的 。 要 让 方法 支持 异步 等 待 ,必须 要 让 方法 的 返回 类 型 为 Task 或 者 Task < TResult 


语 


可 
bo 
Y 
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方法 的 名 称 可 以 用 “Asyne” 结 尾 , 以 标注 它 是 异步 方法 ,例如 RunAsync、DownloadAsync 等 。 
调用 蜡 步 方 法 时 ,可 以 加 上 await 关键 字 ,表示 异步 等 待 。 在 调用 异步 方法 时 ,当前 线 
程 会 进入 等 待 状态 ,但 不 会 阻塞 ; 当 蜡 步 方法 执行 完成 后 ,会 回 到 当前 线程 中 并 继续 执行 后 
面 的 代码 。 在 使 用 了 await 关键 字 的 方法 中 需要 加 上 async 关键 字 ,表示 调用 了 异步 代码 。 
综 上 所 述 , 异 步 方法 的 声明 方法 就 是 让 它 返 回 Task 或 Task < TResult > 实例 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 声明 异步 方法 WorkAsync。 在 方法 内 部 ,直接 通过 Task. Run 方法 返回 Task 


static Task WorkRsync() 
{ 
return Task. Run(() = > Console. WriteLine(" 执 行 异步 代码 …… "ys 


步骤 3: 可 以 用 await 关键 字 调用 上 述 异 步 方 法 。 


static async void Test() 
{ 

await WorkAsync( ); 
} 


由 于 Test 方 法 中 调用 了 异步 方法 ,所 以 要 使 用 async 关键 字 来 修饰 Test 方法 。 
步骤 4: 声明 异步 方法 时 ,还 可 以 创建 Task 实例 ,然后 将 其 返回 。 


static Task SomeAsync() 

{ 
Task t = new Task(() => Console.WriteLine(" 做 些 事 情 ")); 
t. Start(); 
return t; 


注意 : 创建 Task 实例 后 ,在 返回 之 前 必须 要 调用 Start 方法 启动 任务 ,否则 await 关键 字 无 
法 等 待 未 运行 的 任务 。 如 果 在 异步 方法 中 创建 的 新 Task 实例 没有 启动 ,可 以 在 调用 
异步 方法 时 获取 该 Task 实例 的 引用 ,然后 手动 调用 Start 启动 任务 ,再 用 await 关键 
字 异 步 等 待 任务 完成 ,具体 实现 如 下 。 

Task task = SomeAsync(); 

task. Start( ); 

await task; 

从 代码 封装 的 角度 看 ,不 推荐 这 样 做 ,最 合适 的 做 法 是 在 异步 方法 返回 之 前 启动 并 行 
任务 ,这 样 会 显得 比较 友好 ,方便 后 续 使 用 封装 好 的 代码 。 
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实例 297 在 Main 方法 中 使 用 异步 等 待 

【导语 】 

新 版 本 (7.1 或 以 上 版 本 ) 的 C# 语 言 支持 在 Main 方法 中 进行 异步 等 待 ,使 用 方法 为 : 在 
Main 方法 中 使 用 await 关键 字 调 用 异步 方法 ,然后 在 Main 方法 中 添加 async 关键 字 进 行 修饰 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 


步骤 2: 本 例 以 Task. Delay 方法 的 调用 来 做 演示 .此 方法 也 会 返回 一 个 Task 实例 .在 
Main 方法 中 输入 以 下 代码 。 


Console. WriteLine(" 先 等 2 秒 。"); 
await Task. Delay(2000); 
Console. WriteLine(" 再 等 3 秒 ."); 
await Task. Delay(3000); 


Console. WriteLine(" 还 要 等 4 秒 。"); 
await Task. Delay( 4000); 


步骤 3: 在 Main 方法 上 添加 async 修饰 符 。 


static async Task Main(string[ ] args) 
{ 


本 


注意 : 如 果 Main 方法 返回 的 类 型 为 void, 请 将 其 改 为 Task ,目前 只 支持 返回 Task 或 Task 
< int > 类 型 。 


步骤 4: (如 果 编 译 错 误 , 则 需要 执行 此 步骤 ) 打 开 项 目 属性 ,切换 到 * 生 成 ?选项 卡 , 单 击 
页 面 下 方 的 “高 级 "按钮 。 在 打开 的 “高 级 生成 选项 ”窗口 中 ,将 语言 版 本 设置 为 7.1 或 更 高 
版 本 ,或 者 选择 “C# 最 新 次 要 版 本 (最 新 )”, 如 图 10-9 所 示 。 


高 级 x 
常规 
语言 版 本 (U: C# 最 新 次 要 版 本 (最 新 ) ~ 
内 部 编译 器 错误 报告 小 :| 提示 
口 检查 运算 上 溢 / 下 溢 t) 
者 
调试 信息 6 秆 滞 
文件 对 齐 介 : 512 ~ 
库 基 址 (B): Ox00400000 
[ww | 


图 10-9 选择 语言 版 本 
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步骤 5: 运行 应 用 程序 ,控制 台 输出 结果 如 下 。 


先 等 2 秒 。 
再 等 3 秒 。 
还 要 等 4 秒 。 


实例 298 ”为 每 个 线程 单独 分 配 变 量 值 


【导语 】 

在 某 些 应 用 场景 下 ,对 于 同一 个 变量 ,需要 允许 访问 它 的 各 个 线程 都 保留 独立 的 值 , 即 
在 使 用 同一 个 变量 的 情况 下 ,每 个 线程 可 以 为 该 变量 分 配 独 立 的 变量 值 ,这 些 值 只 在 当前 线 
程 中 有 效 。 

要 实现 这 样 的 需求 ,就 要 借助 ThreadLocal < T > 类 ,该 类 的 实例 可 以 在 多 个 线程 之 间 
共享 ,并 且 每 个 线程 可 以 通过 Value 属性 设置 各 自 的 值 , 线 程 与 线程 之 间 互 不 干扰 。 如 果 需 
要 知道 ThreadLocal 变量 被 设置 过 哪些 值 ,可 以 访问 Values 属性 ,要 使 Values 属性 可 用 ， 
在 调用 ThreadLocal 类 的 构造 函数 时 ,需要 调用 带 有 trackAllValues 参数 (bool 类 型 ) 的 重 
载 版 本 ,并 将 trackAllValues 参数 设置 为 true。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Program 类 中 声明 一 个 ThreadLocal <int> 类 型 的 静态 字段 ,并 初始 化 。 


static ThreadLocal < int> _localvar = new ThreadLocal < int>(true) 


本 实例 稍 后 会 访问 Values 属性 ,所 以 在 调用 ThreadLocal 类 构造 函数 时 要 将 
trackAllValues 参数 设置 为 true。 
步骤 3: 创建 三 个 新 线程 ,并 在 线程 所 执行 的 代码 上 修改 ThreadLocal 实例 的 Value 属性 。 


Thread thl = new Thread(() => 

E 
_localvar. Value = 5000; 
Console.WriteLine( $ "在 ID 为 {Thread. CurrentThread. ManagedThreadId} 的 线程 ,本 地 线程 变 
量 的 值 为 :{_localvar. Value}"); 

D; 

thl. Start(); 


Thread th2 = new Thread(() => 

{ 
_localvar. Value = 9000; 
Console.WriteLine( $ "在 ID 为 {Thread. CurrentThread. ManagedThreadId} 的 线程 ,本 地 线程 变 
量 的 值 为 :{_localvar. Value}"); 

D); 

th2. Start(); 
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Thread th3 = new Thread(() => 

{ 
_localvar. Value = 7500; 
Console.WriteLine( $ "在 ID 为 {Thread. CurrentThread. ManagedThreadId} 的 线程 ,本 地 线程 变 
量 的 值 为 :{_localvar. Valuej"); 

D); 

th3. Start(); 


步骤 4: 等 待 三 个 线程 执行 完成 。 


thl1. Join( ); 
th2. Join(); 
th3. Join( ); 


步骤 5: 此 时 ,在 主线 程 代码 中 可 以 访问 Values 的 属性 , 枚 举 出 被 设置 过 的 值 。 
Console. WriteLine("\n 设 置 过 的 所 有 值 :"); 


foreach (int n in _localvar. Values) 


{ 


Console. Write(" {0}", n); 
} 


步骤 6: 运行 应 用 程序 ,得 到 的 结果 如 图 10-10 所 示 。 


图 10-10 基于 线程 的 本 地 变量 


实例 299 保留 异步 上 下 文中 的 本 地 变量 值 

【导语 】 

在 基于 Task 的 异步 等 待 上 下 文中 ,ThreadLocal < 了 > 类 型 的 本 地 变量 无 法 发 挥 作用 ， 
请 思考 以 下 例子 。 

ThreadLocal < string> local = new ThreadLocal < string>(); 


async Task WorkAsync( ) 
{ 


local. Value = "hello"; 
Console. WriteLine(" 异 步 等 待 前 :{0}",， local. Value); 
await Task. Delay(150); 
Console. WriteLine(" 异 步 等 待 后 :{0}"，local. Value) ; 
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在 进入 异步 等 待 前 ,本 地 变量 将 字符 串 常量 赋值 为 “hello”, 随 后 调用 Delay 方法 ,并 异 
步 等 待 方法 返回 。 回 到 当前 上 下 文 后 ,本 地 变量 的 值 变 为 默认 值 (字符 串 的 默认 值 是 null)， 
也 就 是 说 ,之 前 赋值 的 字符 串 “hello” 已 经 读 不 到 了 。 

这 是 因为 基于 并 行 任务 的 异步 上 下 文 是 由 内 部 框架 自动 调度 的 ,异步 等 待 前 后 ,本 地 变 
量 可 能 处 于 不 同 的 线程 上 , 即 await 请 名 使 用 前 后 的 代码 并 不 是 在 同一 个 线程 上 ,所 以 在 等 
待 方法 返回 后 就 取 不 到 本 地 变量 的 值 了 。 要 解决 这 个 问题 ,可 以 用 AsyncLocal < 下 > 类 过 
换 ThreadLocal< 人 > 类 。AsyncLocal < 本 > 类 能 够 在 异步 上 下 文 之 间 保 留 原 有 的 数据 , 即 
使 异步 等 待 前 后 的 代码 不 在 同一 个 线程 上 ,也 能 够 访问 之 前 设置 的 值 。 

以 下 实例 将 演示 AsyncLocal<T> 类 的 用 法 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Program 类 中 声明 一 个 静态 字段 ,类 型 为 AsyncLocal < string >。 


static RsyncLocal < string> local = new RsyncLocal < string>(); 


步骤 3: 定义 一 个 异步 方法 ,在 方法 内 部 调用 Task. Delay 方法 ,并 异步 等 待 方法 返 
进入 异步 等 待 前 ,对 local 变量 赋值 ; 异步 等 待 返回 后 . 读 测 local 变量 的 值 。 


互 


static async Task RunThisCodeAsync() 
{ 
local.Value = "Follow me"; 
Console. WriteLine( "异步 等 待 前 :{0}"， local. Value); 
await Task. Delay(150); 
Console. WriteLine( "异步 等 待 后 :{0}",， local. Value); 
} 


步骤 4: 在 Main 方法 中 调用 RunThisCodeAsync 方 法 。 
RunThisCodeAsync().Wait(); 
步骤 5: 运行 应 用 程序 ,控制 台 输 出 内 容 如 下 。 


异步 等 待 前 :Follow me 
异步 等 待 后 :Follow me 


可 以 看 到 ,等 待 之 前 所 赋 的 值 ,在 异步 上 下 文 返回 后 仍然 能 顺利 地 读 取 。 

实例 300 取消 并 行 任务 

【导语 】 

在 实际 开发 中 ,经 常会 遇 到 在 后 台 使 用 Task 执行 一 些 比较 耗 时 间 代码 的 情况 。 出 于 
友好 的 用 户 体验 考虑 ,在 执行 长 时 间 任 务 的 过 程 中 应 该 向 用 户 反馈 处 理 进度 ; 此 外 ,由 于 运 


行 耗 时 较 长 ,用户 可 能 不 想 再 继续 等 待 ,应 该 允许 用 户 取消 任务 。 
CancellationTokenSource 类 提供 了 取消 任务 的 处 理 模 型 ,通过 Token 属性 可 以 获得 
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CancellationToken 结构 实例 的 副本 。 所 有 被 复制 的 CancellationToken 对 象 都 会 监听 
CancellationTokenSource 实例 的 状态 , 一旦 CancellationTokenSource 实例 调用 了 Cancel 
方法 , 各 个 CancellationToken 副本 就 会 收 到 通知 , 此 时 CancellationToken 对 象 的 
IsCancellationRequested 属性 就 会 返回 true。 可 以 通过 检查 IsCancellationRequested 属性 
来 判断 并 行 任务 是 否 被 取消 。 

本 实例 将 演示 一 个 累加 运算 ,计算 过 程 用 一 个 异步 方法 封装 。 调 用 方法 时 ,可 以 传递 一 
个 整数 值 ,表示 参与 累加 运算 的 最 大 值 , 计 算 将 从 0 开始 累加 ,直到 最 大 值 ,例如 ,最 大 值 为 
5, 那 么 就 计算 0 十 1 十 2 十 3 十 4 十 5。 在 程序 执行 运算 的 过 程 中 ,用 户 随 时 可 以 按 下 C 键 取 消 


企稳 5 


【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 定义 用 于 执行 累加 计算 的 异步 方法 。 


static Task < int > RunAsync( int maxNum, CancellationToken token = default) 


t 


TaskCompletionSource< int > tcl = new TaskCompletionSource < int >(); 
int x = 0; 
int res = 0; 
while(x < maxNum) 
{ 
if (token. IsCancellationRequested) 


‘ 
break; 
} 
res += x; 
x += 1; 


Task. Delay(500). Wait(); 
} 
tc1. SetResult(res); 
return tcl. Task; 


token 参数 用 于 监听 任务 是 否 被 取消 。 本 方法 中 使 用 了 TaskCompletionSource 


< TResu 
问 Task 


t> 类 ,这 个 类 可 以 灵活 地 设置 Task 的 运行 结果 (通过 SetResult 方法 设置 ), 青 访 


属性 就 能 获取 要 返回 的 并 行 任务 实例 。 


步骤 3: 在 Main 方法 中 实例 化 CancellationTokenSource。 


CancellationTokenSource cansrc = new CancellationTokenSource(); 


步骤 4: 在 调用 累加 计算 的 异步 方法 之 前 ,可 以 开启 一 个 并 行 任务 ,用 于 判断 用 户 是 否 
按 下 了 C 键 ,如 果 是 ,就 调用 CancellationTokenSource 对 象 的 Cancel 方法 。 
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Task.Run(() => 
{ 
Console. WriteLine(" 按 C 键 取 消 任务 。"); 


while (true) 
{ 


var info = Console. Readkey(true); 
证 (info. Key == ConsoleKey.C) 
{ 


cansrc. Cancel(); 
break; 


} 
D; 


步骤 5: 调用 异步 方法 ,并 等 待 计算 完成 。 

int result = await RunAsync(200, cansrc. Token); 

Console. WriteLine(" 计 算 结果 :{0}"， result); 

访问 Token 属性 ,会 复制 一 份 CancellationToken 实例 ,并 能 够 监听 Cancel 方法 的 
调用 。 

步骤 6: 当 不 再 使 用 CancellationTokenSource 对 象 时 ,需要 将 其 释放 。 


cansrc. Dispose(); 


步骤 7: 运行 应 用 程序 ,累加 计算 开始 。 此 过 程 中 如 果 按 下 C 键 ,任务 被 取消 ,并 把 已 
经 完成 的 部 分 计算 结果 返回 .如 图 10-11 所 示 。 


图 10-11 已 取消 的 并 行 任务 


网 络 编 程 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。 基于 Socket 的 网 络 通 信 ; 
。 HTTP 编程 。 


11.1 Socket 通信 


实例 301 简单 的 TCP 通信 程序 


【导语 】 
TCP 是 基于 连接 的 通信 协议 ,Socket 可 以 视 为 两 个 终结 点 之 间 用 于 对 话 的 标识 。 
- 般 来 说 ,在 服务 器 上 至 少 需要 两 个 Socket 实例 来 完成 通信 工作 。 一 个 Socket 实例 

会 绑 定 服务 器 主机 的 地 址 和 端口 ,然后 监听 客户 端的 连接 , 当 收 到 客户 端的 连接 后 ,会 产生 
另 一 个 Socket 实例 ,此 Socket 实例 主要 负责 双方 的 通信 , 即 在 服务 器 与 客户 端 之 间 发 送 和 
接收 数据 。 在 客户 端 主机 上 ,通常 只 需要 一 个 Socket 实例 ,该 Socket 实例 首先 要 向 服务 器 
发 起 连接 请 求 ,连接 成 功 后 就 可 以 与 服务 器 通信 了 

【操作 流程 】 

以 下 为 服务 器 的 实现 部 分 。 

步骤 1: 创建 用 于 监听 连接 的 Socket 实例 。 


Socket server = new Socket(SocketType. Stream, ProtocolType. Tcp); 


步骤 2: 绑 定 本 地 终结 点 。 本 实例 中 将 绑 定 到 本 地 环 回 地 址 (IP 为 127. 0. 0. 1) ,端口 号 
为 6000 。 


// 本 地 监听 地 址 
IPEndPoint localSv = new IPEndPoint(IPAddress. Loopback, 6000); 
// 绑 定 本 地 端点 


server. Bind(localSv); 
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步骤 3: 调用 Listen 方法 ,开始 监听 连接 。 
server. Listen(10); 


Listen 方法 有 一 个 backlog 参数 ,用 于 指定 队列 中 等 待 的 连接 数 , 此 数值 根据 实际 情况 
设 定 ,本 实例 中 设 定 为 10。 

步骤 4: 调用 Accept 方法。 调用 之 后 服务 器 Socket 会 处 于 等 待 状态 ,一旦 接收 到 客户 
端的 连接 ,就 会 返回 一 个 新 的 Socket 实例 ,该 Socket 实例 将 用 于 通信 。 


Socket client = server.Accept(); 
步骤 5: 此 时 可 以 进行 通信 了 ,本 例 仅 向 客户 端 发 送 一 条 字符 串 消 息 。 


string message = "你 好 ,我 是 服务 器 。": 

byte[ ] data = Encoding.UTF8.GetBytes(message); 

// 发 送 数据 长 度 

client. Send(BitConverter. GetBytes(data. Length) ); 

// 发 送 数据 正文 

client. Send(data); 

发 送 数据 调用 Send 方法 ,数据 都 是 以 字 节 序列 形式 发 送 的 ,因此 字符 串 内 容 要 先 转换 
为 字 节 序列 。 

由 于 通信 和 是 基于 流 的 方式 处 理 的 ,数据 均 为 连接 的 字 节 序列 ,容易 出 现 “ 粘 包 ” 现 象 , 即 
前 一 条 消息 可 能 与 后 一 条 消息 混合 在 一 起 了 ,导致 无 法 判断 数据 的 具体 长 度 。 因 此 ,比较 保 
险 的 方案 是 先 把 数据 正文 的 长 度 发 送 过 去 (一 般 为 int 值 或 long 值 ) ,然后 再 发 送 数据 正文 ; 
接收 方 在 读 取 数 据 时 ,可 以 先 读 取 数据 长 度 , 然 后 再 读 取 数 据 正文 ,这 样 可 以 保证 数据 传输 
的 准确 性 。 

步骤 6: 关闭 Socket 对 象 ,释放 资源 。 

client. Close( ); 

server. Close( ); 

以 下 是 客户 端的 实现 部 分 。 

步骤 7: 在 客户 端 上 创建 Socket 实例 。 客 户 端 上 一 般 只 需要 单个 Socket 实例 即 可 完 
成 通信 。 

Socket client = new Socket(SocketType.Stream, ProtocolType. Tcp); 


步骤 8: 调用 Connect 方法 ,向 服务 器 发 起 连接 。 


client. Connect(IPAddress. Loopback, 6000); 


注意 : 客户 端 在 发 起 连接 时 ,请 确保 所 指定 的 地 址 和 端口 号 与 服务 器 所 绑 定 的 地 址 和 端口 
号 匹配 。 
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步骤 9: 读 取 数据 长 度 。 


byte[ ] data = new byte[sizeof (int)]; 
int dataLen = 0; 
int n = client. Receive(data); 
if(n == data. Length) 
| 
dataLen = BitConverter. ToInt32(data, 0); 
} 


服务 器 发 送 的 数据 长 度 是 int 类 型 ,为 4 字 节 ,在 读 取 后 也 要 相应 地 转换 为 int 类 型 。 
步骤 10: 读 取 数据 正文 ,并 解析 出 字符 串 。 

data = new byte[ dataLen]; 

client. Receive(data); 


string msg = Encoding. UTF8.GetString(data); 
Console. WriteLine( $"\n 客户 端 收 到 服务 器 的 消息 :\n{msg}"); 


步骤 11: 断 开 连 接 。 


client. Disconnect (false); 


Disconnect 方法 需要 一 个 reuseSocket 参数 , 表 
示 稍 后 是 否 还 能 继续 使 用 该 Socket 实例 。 在 本 例 
中 ,通信 已 经 完成 ,无 须 再 使 用 该 Socket 实例 ,因此 
可 以 指定 为 false。 

步骤 12: 关闭 Socket 对 象 ,释放 资源 。 


client. Close() 
步骤 13: 运行 应 用 程序 .控制 台 输出 结果 如 
图 11-1 所 示 。 


图 11-1 TCP 通信 示例 


实例 302 TcpListener 与 TcpClient 


TcpListener 类 与 TcpClient 类 是 框架 提供 的 封装 类 型 ,它们 包装 了 基于 TCP 协议 的 
Socket 通信 ,使 网 络 编程 变 得 更 简单 。 

TcpListener 类 负责 两 件 -是 开启 或 停止 监听 来 自 客户 端的 连接 请 求 ; 二 是 接 
连接 ,并 产生 一 个 新 的 TcpClient 实例 (用 于 通信 )。 

TcpClient 类 仅 用 于 发 送 或 接收 消息 。 在 服务 器 上 ,该 类 的 实例 由 TcpListener 实例 的 
AcceptTcpClient 方法 返回 ; 在 客户 端 ,只 需要 使 用 单个 TcpClient 实例 即 可 完成 通信 ,但 在 
通信 之 前 要 调用 Connect 方法 连接 服务 器 。 经 过 封装 后 ,TcpClient 类 将 以 流 的 方式 发 送 和 
接收 数据 , 这 使 得 数据 传输 变 得 更 易于 掌控 。 建 立 连接 后 ,调用 TcpClient 实例 的 
GetStream 方法 ,得 到 一 个 NetworkStream 实例 。NetworkStream 类 从 Stream 类 派生 ,可 


冲 
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以 很 方便 地 写 入 或 读 取 字 节 序列 。 

本 实例 将 演示 以 下 通信 功能 : 服务 器 使 用 TcpListener 类 进行 监听 ,客户 端 用 
TcpClient 类 发 起 连接 请 求 。 当 连接 建立 之 后 ,客户 端 发 送 一 条 文本 消息 给 服务 器 ,服务 器 
接收 到 消息 后 将 其 输出 到 控制 台 。 

【操作 流程 】 

以 下 是 服务 器 部 分 。 

步骤 1: 创建 TcpListener 实例 ,监听 端口 为 1763, 地 址 为 本 地 计算 机 的 任意 地 址 。 


TcpListener server = new TcpListener(IPhddress. Any, 1763); 
步骤 2: 调用 Start 方法 ,开始 监听 。 

server. Start() ; 

步骤 3: 等 待 客 户 端的 连接 。 

TepClient client = server. AcceptTepClient(); 

步骤 4: 建立 连接 后 , 读 取 从 客户 端 发 来 的 消息 。 


using(NetworkStream stream = client.GetStrean()) 
E 

List<byte> data = new List <byte>(); 

byte[ ] buffer = new byte[256]; 

intn = 0; 

while((n = stream.Read(buffer)) != 0) 

LE 

data. AddRange(buffer. Take(n)); 

. 

// 转换 为 字符 串 

string msg = Encoding.UTF8.GetString(data. ToArray()); 

Console. WriteLine( $"\n 来 自 客户 端的 消息 : {msg}"); 
} 


步骤 5: 调用 Stop 方法 ,停止 监听 。 
server. Stop(); 


以 下 为 客户 端 部 分 。 
步骤 6: 创建 TcpClient 实例 。 


TepClient client = new TcpClient(); 
步骤 7: 向 服务 器 发 起 连接 请 求 。 
client. Connect(IPAddress. Parse("127.0.0.1"), 1763); 


步骤 8: 向 服务 器 发 送 消息 。 
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using(NetworkStream stream = client.GetStrean()) 
{ 
string ct = ".NET Core 网 络 编程 "; 
byte[ ] data = Encoding. UTF8. GetBytes(ct); 
stream. Write(data); 


} 


步骤 9: 运行 应 用 程序 ,可 以 从 控制 台 的 输出 图 11-2 ”从 客户 端 发 来 的 消息 
中 看 到 服务 器 所 接收 到 的 消息 ,如 图 11-2 所 示 。 


实例 303 ”使 用 UdpClient 类 开发 简单 的 聊天 程序 


【导语 】 

UdpClient 类 是 一 个 封装 类 ,包含 了 Socket 上 UDP 协议 与 通信 相关 的 功能 ,使 基于 
UDP 协议 的 通信 编程 更 简单 。 由 于 UDP 协议 是 无 连接 .无 序 的 ,因此 只 需要 单个 
UdpClient 实例 即 可 完成 通信 。 在 收发 数据 之 前 无 须 建立 连接 ,直接 调用 Send 方法 就 可 以 
将 数据 发 送 到 指定 主机 的 特定 端口 上 。 数 据 接收 方 也 可 以 直接 调用 Receive 方法 接收 远程 
主机 发 来 的 消息 。 

为 了 便于 理解 ,本 实例 仅 实现 了 单 向 聊天 程序 , 即 服务 器 只 负责 接收 并 显示 消息 ,客户 
端 只 能 用 于 发 送 消息 。 

【操作 流程 】 

以 下 为 服务 器 的 实现 步骤 。 

步骤 1: 实例 化 UdpClient 对 象 。 


UdpClient udpServer = new UdpClient(9000); 


上 述 代码 调用 了 带 一 个 int 类 型 参数 的 构造 函数 ,port 参数 指定 服务 器 用 于 接收 数据 
的 本 地 端口 号 , 若 未 指定 本 地 地 址 则 表明 服务 器 会 监听 本 地 计算 机 上 的 所 有 地 址 。 
步骤 2: 通过 一 个 循环 来 不 断 接收 消息 , 遇 到 “end” 消 息 时 退出 。 


while(true) 
{ 
UdpReceiveResult result = await udpServer. ReceiveAsync(); 


string msg = Encoding.UTF8.GetString(result. Buffer); 
// 如 果 消 息 是 “end”, 表示 退 出 
if (msg.ToLower().Equals("end")) 
{ 
break; 
} 
// 否则 显示 收 到 的 消息 
string host = result. RemoteEndPoint. Address.MapToIPv4().ToString(); 
Console. WriteLine( $ "来 自 {host} :{msg}"); 
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步骤 3: 调用 Close 方法 关闭 通信 通道 。 
udpServer. Close( ); 

以 下 为 客户 端的 实现 步骤 。 

步骤 4: 创建 UdpClient 实例 。 

UdpClient udpClient = new Udpclient(); 

步骤 5: 以 下 变量 表示 服务 器 的 主机 名 与 端口 号 。 


// 服务 器 主机 名 
string serverHost = "127.0.0.1"; 
// 服务 器 端口 号 


int serverPort = 9000; 


步骤 6: 通过 循环 允许 用 户 发 送 多 条 消息 。 要 发 送 的 消息 来 自 键盘 输入 ,如 果 遇 到 end 


while (true) 
{ 
Console. Write(" 请 输入 消息 内 容 :"); 
string msg = Console. ReadLine(); 
byte[ ] data = Encoding. UTF8. GetBytes(msg); 
udpClient. Send(data, data. Length, serverHost, serverPort); 
// 如 果 是 “end” 则 退出 
if (msg.ToLower().Equals("end")) 
. 
break; 
} 
} 


步骤 7: 最 后 关闭 通信 通道 。 
udpClient. Closel ) 


步骤 8: 运行 应 用 程序 ,在 客户 端 应 用 程序 中 
输入 要 发 送 的 消息 ,并 按 下 Enter 键 ,随后 服务 器 应 
用 程序 上 会 显示 收 到 的 消息 ,如 图 11-3 所 示 。 


11.2 HTTP 编程 
实例 304 从 Web 服务 器 上 下 载 图 片 


【导语 】 
运行 本 实例 后 ,通过 键盘 输入 Web 服务 器 上 图 片 的 URL, 按 下 Enter 键 后 ,应 用 程序 
会 把 图 片 下 载 到 本 地 并 保存 到 文件 中 。 
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本 实例 使 用 了 HttpWebRequest 类 和 HttpWebResponse 类 来 完成 图 片 下 载 , 这 两 个 类 
- 般 是 成 对 使 用 的 。 由 HttpWebRequest 对 象 向 服务 器 发 起 请 求 , 若 服务 器 回应 则 返回 一 

个 HttpWebResponse 对 象 ,通过 HttpWebResponse 对 象 可 以 以 流 的 方式 读 取 来 自 Web 服 
务 器 的 数据 。 如 果 要 将 数据 上 传 到 Web 服务 器 ,应 该 使 用 从 HttpWebRequest 对 象 中 获得 
的 流 对 象 。 总 结 为 一 句 话 就 是 ，HttpWebRequest 对 象 用 于 向 服务 器 写 数据 ， 
HttpWebResponse 对 象 用 于 读 取 来 自 服务 器 的 数据 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 获取 键盘 输入 的 图 片 URL。 

Console. WriteLine(" 请 输入 图 片 的 URL:"); 

string picUrl = Console. ReadLine(); 

步骤 3: 创建 HttpWebRequest 实例 。 该 类 没有 公共 的 构造 函数 ,需要 通过 调用 
WebRequest 的 Create 方法 或 者 CreateHttp 方法 来 获得 HttpWebRequest 实例 的 引用 。 


HttpWebRequest request = WebRequest. CreateHttp(picUr1) 

步骤 4: 设置 访问 方式 为 GET。 

request. Method = "GET"; 

步骤 5: 向 Web 服务 器 发 起 请 求 , 并 获取 HTTP 的 响应 消息 。 
HttpWebResponse response = (HttpWebResponse)request.GetResponse(); 


步骤 6: 读 取 Web 服务 器 响应 的 数据 ,并 写 入 文件 。 


using( Stream respStream ~ response.GetResponseStream()) 


// 写 入 文件 

using (Filestream fs = new FileStream ("down. jpg", 
FileMode. Create) ) 

{ 

respStream. CopyTo(fs); 

} 
} 
步骤 7: 运行 应 用 程序 ,输入 图 片 URL, 然 后 按 下 


Enter 键 ,图 片 随即 被 下 载 到 本 地 文件 ,如 图 11-4 所 示 。 
实例 305 ”使 用 HttpClient 类 向 Web 服务 器 提交 数据 


【导语 】 
HttpClient 类 对 HTTP 通信 中 的 常用 操作 进行 了 封装 ,为 每 一 种 请 求 定义 了 对 应 的 方 
法 ,具体 方法 如 下 。 


图 11-4 从 Web 服务 器 上 下 载 图 片 
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(1) GetAsync 方 法 : 以 GET 方式 发 送 HTTP 请 求 。 

(2) PostAsync 方 法 ; 以 POST 方式 发 送 请 求 。 

(3) PutAsync 方 法 : 以 PUT 方式 发 送 请 求 。 

(4) DeleteAsync 方 法 : 对 应 DELETE 请 求 方式 。 

(5) PatchAsync 方 法 ; 以 PATCHI 方式 发 送 请 求 。 

其 中 ,最 为 常用 的 是 GetAsync 与 PostAsync 两 个 方法 。 此 外 ,HttpClient 类 还 提供 了 
SendAsync 方法 ,此 方法 比较 灵活 ,在 发 送 HTTP 请 求 前 可 以 做 更 多 的 配置 。 

要 提交 的 数据 正文 将 由 HttpContent 类 包装 ,该 类 是 抽象 类 , 需 根据 实际 要 提交 内 容 的 
格式 来 选择 ,例如 ,ByteArrayContent 类 用 于 包装 字 节 数组 ,StringContent 类 用 于 包装 字符 
串 内 容 , 若 希望 以 流 的 形式 提交 数据 ,还 可 以 用 StreamContent 类 。 

本 实例 将 演示 如 何 使 用 HttpClient 类 以 POST 方式 向 Web 服务 器 提交 字符 串 数据 。 

【操作 流程 】 

步骤 1: 创建 HttpClient 实例 。 


using (HttpClient client = new HttpClient()) 
{ 


} 

步骤 2: 包装 要 发 送 的 数据 内 容 。 

StringContent content = new StringContent(" 小 李 ", Systen. Text. Encoding. UTF8); 

本 例 要 发 送 的 是 字符 串 内 容 , 因 此 选用 StringContent 类 进行 包装 。 

步骤 3: 向 服务 器 发 起 请 求 ,方式 为 HTTP-POST。 

string url = "< 目标 URL>"; 

HttpResponseMessage response = await client.PostAsync(url, content); 

上 述 代码 中 ,请 将 < 目标 URL > 替换 为 实际 的 测试 地 址 。 

步骤 4: 调用 PostAsync 方法 后 ,异步 返回 HttpResponseMessage 对 象 ,表示 服务 器 加 
应 的 消息 ,从 HttpResponseMessage 对 象 的 Content 属性 中 可 以 得 到 服务 器 返回 的 数据 
正文 。 


string respmsg = await response. Content. ReadAsStringAsync(); 


Console. WriteLine( $ "提交 成 功 ,服务 器 回应 消息 :{respnsg}"); 


注意 : 本 实例 的 源 代码 中 包含 一 个 简单 的 ASP. NET Core 项 目 ,测试 时 可 以 同时 运行 此 
Web 项 目 。 


反射 与 Composition 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
"反射 技术 ， 


*。 Composition 。 


12.1 反射 技术 


实例 306 ”获取 程序 集中 的 类 型 列表 


【导语 】 

反射 技术 可 以 在 应 用 程序 运行 阶段 对 程序 集 进行 解析 ,包括 获取 程序 集中 的 类 型 .类 型 
的 成 员 列 表 , 参 数列 表 等 信息 ,还 可 以 创建 类 型 实例 或 调用 类 型 成 员 。 

本 实例 演示 了 如 何 列 出 指定 类 库 中 的 类 型 。 

【操作 流程 】 

步骤 1: 编写 一 个 测试 类 库 , 它 包含 一 个 CoolComponents 命名 空间 ,命名 空间 下 包 
三 个 自 定义 类 型 。 


ww 


namespace CoolComponents 

{ 
public class CoolEngin { } 
public struct FaultData { } 
public class FastBuilder { } 

} 


步骤 2: 生成 类 库 项 目 , 将 输出 的 . dll 文件 复制 到 示例 应 用 程序 的 \bin\Debug\ 
netcoreapp < 版 本 号 > 目录 下 。 

步骤 3: 打开 示例 项 目的 Program. cs 文件 ,引入 以 下 命名 空间 ,与 反射 技术 有 关 的 类 型 
都 位 于 这 个 命名 空间 下 。 


using System. Reflection; 
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步骤 4: 调用 Assembly 类 的 静态 方法 LoadFrom, 从 . dll 文件 中 加 载 程序 集 。 


Rssembly ass = Assembly.LoadFrom("TestLib.d11"); 


加 载 的 程 


步骤 5: 调用 GetTypes 方法 ,返回 此 程序 集中 所 包含 类 型 ,以 Type 数组 的 形式 返 


TYpe[ ] types = ass.GetTypes(); 


序 集 以 Assembly 类 表示 ,通过 这 个 类 可 以 获取 类 型 列表 。 


回 


步骤 6: 在 控制 台中 输出 各 类 型 的 完整 名 称 ( 包 括 命名 空间 和 类 型 的 名 称 ) 和 性 质 (引用 


类 型 或 值 类 型 


) 。 


foreach (Type t in types) 


Console. Write("{0} — ", t.FullNane); 


证 (t. 


IsClass) 


Console. Write(" 引 用 类 型 "); 
else if (t. IsValueType) 
Console. Write(" 值 类 型 "); 


else 


Console. Write(" 其 他 类 型 "); 
Console. Write("\n"); 


} 


IsClass 标识 类 型 为 引用 类 型 (类 属于 引用 类 
型 ) ,结构 是 值 类 型 ,所 以 也 可 以 用 IsValueType 
属性 来 判断 某 个 类 型 是 否 为 结构 ( 枚 举 是 特殊 的 
值 类 型 ,可 用 IsEnum 属性 来 判断 ) 。 


rogram Files\dotnet\dot 


步骤 7: 运行 应 用 程序 ,输出 结果 如 图 12-1 图 12-1 解析 出 类 库 中 的 类 型 列表 


所 示 。 


实例 307 ”获取 指定 类 型 的 成 员 列 表 


【导语 】 


如 果 需 要 获取 指定 类 型 的 所 有 成 员 , 可 以 调用 Type 类 的 GetMembers 方法 。 如 果 需 
要 获取 特定 的 成 员 , 可 以 访问 以 下 方法 : 
(1) 获取 方法 : 调用 GetMethod 或 者 GetMethods 方法 。 


(2) 获取 


属性 : 调用 GetProperty 或 者 GetProperties 方法 。 


(3) 获取 事件 : 调用 GetEvent 或 者 GetEvents 方法 。 

(4) 获取 构造 函数 : 调用 GetConstructor 或 者 GetConstructors 方法 。 

(5) 获取 字段 : 调用 GetField 或 者 GetFields 方法 。 

其 中 ,复数 命名 的 方法 用 于 获取 多 个 成 员 对 象 ,例如 ,GetProperty 方法 可 以 获取 单个 
属性 的 信息 ,而 GetProperties 方法 则 可 以 获取 多 个 属性 的 信息 。 

本 实例 在 获取 类 型 成 员 时 ,不 考虑 成 员 分 类 ,因此 使 用 GetMembers 方法 ; 不 带 参数 的 
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GetMembers 方法 可 获取 指定 类 型 的 公共 成 员 列 表 ; 如 果 需 要 获取 非 公共 成 员 , 则 可 以 调 
用 带 有 BindingFlags 枚 举 参数 的 GetMembers 方法 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 以 String 类 为 例 , 获 取 类 型 关联 的 Type 对 象 。 


Type targetType = typeof(string); 
步骤 3: 获取 String 类 的 公共 与 非 公 共 成 员 ,实例 与 静态 成 员 。 


MemberInfo[ ] menbers = targetType. GetMembers(BindingFlags. Instance | BindingFlags. Static | 
BindingFlags. NonPublic | BindingFlags. Public); 


须 创建 类 型 实例 ,可 以 直接 访问 的 成 员 ,在 声明 静态 成 员 时 会 加 上 static 关键 字 。 
步骤 4: 在 控制 台中 输出 成 员 的 名 称 及 类 别 。 


foreach(MemberInfo mbinfo in members) 
{ 


Console. Write( $ " {mbinfo. MemberType, — 15} : {mbinfo. Name} \n"); 
} 
MemberInfo 类 的 MemberType 属性 是 一 个 MemberTypes 枚 举 , 标 识 成 员 的 类 别 。 例 
如 ,对 于 方法 成 员 ,其 枚 举 值 为 Method; 对 于 属性 成 员 ,其 枚 举 值 为 Property。 
步骤 5: 运行 应 用 程序 ,输出 结果 如 图 12-2 所 示 。 


:firstCha 


图 12-2 String 类 的 成 员 列表 
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实例 308 ”获取 方法 的 参数 信息 


【导语 】 

MethodInfo 类 封装 了 常规 方法 (不 包括 构造 函数 ) 的 相关 信息 ,通过 访问 Type 实例 的 
GetMethod 方法 可 以 返回 单个 MethodInfo 实例 。 

要 得 到 方法 的 参数 列表 信息 ,需要 访问 MethodInfo 实例 的 GetParameters 方法 ,调用 
后 会 返回 一 个 ParameterInfo 类 的 数组 。ParameterInfo 类 封装 了 参数 信息 , 其 
ParameterType 属性 表示 参数 的 数据 类 型 ,Name 属性 可 以 获取 参数 名 称 。 如 果 参 数 带 有 
out 关键 字 , 可 以 使 用 ISOut 属性 来 检测 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 一 个 Sample 类 ,类 中 包含 一 个 实例 方法 ChangeRate。 


public class Sample 
{ 
public double ChangeRate(uint af, float xf) 
{ 
return default(double); 


} 


稍 后 将 通过 反射 技术 获取 ChangeRate 方法 的 参数 列表 。 
步骤 3: 获取 类 型 相关 的 Type 对 象 。 


Type tp = typeof(Sample); 
步骤 4: 调用 GetMethod 方法 查找 出 ChangeRate 方法 。 
MethodInfo mtinfo = tp.GetMethod(nameof(Sample. ChangeRate) ) 


步骤 5: 获取 参数 列表 ,并 输出 参数 信息 (参数 名 与 参数 所 属 的 数据 类 型 ) 。 


if(mtinfo != null) 
{ 
// 获取 参数 列表 
ParameterInfo[ ] prms -= mtinfo.GetParameters(); 
Console. WriteLine( $ "{mtinfo. Name} 方法 有 {prms.Length} 个 参数 ,它们 分 别 是 :"); 
foreach(ParameterInfo pi in prns) 
L 
Console. WriteLine( $ " {pi. Name} : {pi.ParameterType}"); 
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步骤 6: 运行 应 用 程序 ,输出 结果 如 图 12-3 所 示 。 


an - OO 


芬 效 ， 它 们 分别 症 : 


12-3 ”ChangeRate 方法 的 两 个 参数 


实例 309 通过 反射 调用 构造 困 数 


【导语 】 

构造 函数 信息 由 ConstructorInfo 类 封装 ,该 类 从 MethodBase 类 派生 (构造 函数 属于 
种 特殊 的 方法 )。 可 以 调用 Type 类 实例 的 GetConstructor 或 者 GetConstructors 方法 来 获 
取 与 类 型 构造 函数 有 关 的 ConstructorInfo 实例 。 要 调用 构造 函数 ,需要 访问 Invoke 方法 ， 
Invoke 方法 所 返回 的 就 是 类 型 的 新 实例 (统一 以 object 类 型 返回 ,必要 时 可 以 在 使 用 新 实 
例 前 进行 类 型 转换 ) ,该 方法 需要 一 个 object 数组 作为 输入 参数 , 它 表 示 传 递 给 构造 函数 的 
参数 列表 ; 如 果 构 造 函 数 是 无 参数 的 ,可 以 传递 null。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Pen 类 , 它 包含 一 个 StrokeWidth 属性 ,一 个 无 参数 的 构造 函数 ,在 该 构造 
函数 中 初始 化 StrokeWidth 属性 。 


namespace Samples 
{ 
public class Pen 


{ 
public float StrokeWidth { get; private set; } 


public Pen() 


€ 
StrokeWidth = 1.2f; 


} 
} 
步骤 3: 回 到 Main 方法 中 ,获取 与 Pen 类 相关 的 Type 对 象 。 
Type testType = typeof(Samples. Pen); 
步骤 4: 调用 GetConstructor 方法 获取 构造 函数 引用 。 
onstructorInfo constr = testType. GetConstructor(TYpe. EmptyTypes); 


GetConstructor 方法 需要 提供 构造 函数 的 参数 列表 ,由 于 Pen 的 公共 函数 是 无 参数 的 ， 
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所 以 可 以 直接 使 用 Type 类 中 公开 的 EmptyTypes 字段 , 它 会 返回 一 个 空 的 Type 数组 。 
步骤 5: 调用 构造 函数 ,创建 Pen 类 的 新 实例 ,然后 读 取 StrokeWidth 属性 的 值 。 


ConstructorInfo constr = testType.GetConstructor(Type. EnptyTypes); 
if (constr != null) 
t 

// 创建 类 实例 

object instance = constr. Invoke(null1); 

// 查找 StrokeWidth 属性 

PropertyInfo prop = testType. GetProperty("StrokeWidth"); 

// 获取 属性 值 

object val = prop.GetValue(instance); 

Console. WriteLine("StrokeWidth 属性 的 值 为 :{0}"， val); 


} 


使 用 PropertyInfo 类 的 GetValue 方法 可 以 获得 相应 属性 的 值 。 
步骤 6: 运行 应 用 程序 ,输出 结果 如 下 。 


StrokeWidth 属性 的 值 为 :1.2 
实例 310 ”通过 反射 调用 静态 方法 


【导语 】 
MethodInfo 类 的 Invoke 方 法 的 常用 重 载 如 下 。 


object Invoke(object obj，object[ ] parameters); 


如 果 要 调用 的 方法 是 静态 的 (声明 时 使 用 static 关键 字 ) .那么 在 调用 Invoke 方法 时 
obj 参数 应 为 null, 因 为 访问 静态 成 员 并 不 依赖 类 型 实例 。 

本 实例 将 演示 如 何 运 用 反射 技术 来 调用 带 有 两 个 double 类 型 参数 的 静态 方法 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Program 类 中 定义 一 个 静态 方法 ,名 为 Add, 它 接受 两 个 double 类 型 的 参 
数 ,并 返回 两 个 参数 相 加 的 总 和 。 


public static double Add(double a double b) =>a + b; 
步骤 3: 在 Main 方法 中 ,获取 与 Add 方法 相关 的 MethodInfo 实例 。 


MethodInfo addMthd = typeof (Program), GetMethod("Add", BindingFlags. Public | BindingFlags. 
Static); 


要 查找 类 型 中 的 静态 成 员 ,BindingFlags 枚 举 需要 加 上 Static 值 。 
步骤 4: 调用 Add 方 法 。 


if(addMthd != null) 
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// 要 传 给 方法 的 参数 值 列表 
object[] prns = { 3.65d, 17.073d }; 
// 调用 方法 


object returnVal = addMthd. Invoke(null, prms); 
Console. WriteLine( $ "静态 方法 调用 结果 :{returnVal}"); 
} 


步骤 5: 运行 应 用 程序 ,输出 结果 如 下 。 
静态 方法 调用 结果 :20. 723 


实例 311 用 Activator 类 创建 类 型 实例 


【导语 】 

除了 通过 ConstructorInfo 来 创建 类 型 实例 外 ,还 可 以 使 用 Activator 类 。 这 是 一 个 静 
态 类 .因此 它 的 所 有 成 员 方法 都 是 静态 方法 ,该 类 仪 包含 一 个 方法 一 一 CreatelInstance, 用 于 
创建 类 型 实例 .但 该 方法 有 多 个 重 载 ,最 为 常用 有 以 下 两 个 版 本 : 

(1) 当 要 使 用 类 型 中 带 无 参数 的 构造 函数 时 ,应 调用 以 下 重 载 : 


static object CreateInstance(Type type); 


(2) 当 要 使 用 类 型 中 带 参 数 的 构造 函数 时 ,就 要 调用 以 下 重 载 : 


static object CreateInstance(Type type, params object[] args); 


args 是 传递 给 构造 函数 的 参数 值 列表 ,依照 构造 函数 声明 的 参数 顺序 传人 即 可 。 
【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 Person 类 ,该 类 的 构造 函数 需要 三 个 参数 。 


public class Person 
{ 
public Person( string name, string city, int age) 
{ 
Name = name; 
City = city; 
Ge = age} 


public string Name { get; } 
public string City { get; } 
public int Mge { get; } 
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步骤 3: 获取 Person 类 关联 的 Type 对 象 。 

Type theType = typeof (Person); 

步骤 4: 创建 Person 实例 。 

object instance = Activator. CreateInstance(theType, "Mee Yang", "Zhong Shan", 21); 

由 于 Person 类 的 构造 函数 需要 三 个 参数 ,因此 在 调用 CreateInstance 方法 时 要 传递 相 
应 的 参数 值 。 

步骤 5: 现在 ,Person 类 的 实例 已 经 创建 。 下 面 代码 将 通过 反射 枚 举 出 Person 对 象 的 
公共 属性 ,然后 输出 各 个 属性 的 值 。 


PropertyInfo[ ] props = theType.GetProperties(BindingFlags. Instance | BindingFlags.Public); 
foreach(PropertyInfo p in props) 
{ 


Console. WriteLine( $ "{p. Name} : {p.GetValue(instance)}"); 


} 
要 一 次 性 获取 多 个 属性 的 信息 ,应 当 调 用 Type 对 象 的 ”图 12-4 输出 Person 对 
GetProperties 方法 。 象 的 公共 属性 


步骤 6: 运行 应 用 程序 ,输出 结果 如 图 12-4 所 示 。 
实例 312 ”检测 类 型 上 所 应 用 的 自 定 义 Attribute 


【导语 】 

CustomAttributeExtensions 类 提供 了 一 系列 扩展 方法 ,可 以 获取 程序 集 、 类 型 、 类 型 成 
员 参数 上 应 用 的 自 定义 特性 (Attribute) 实 例 。 

如 果 事 先知 道 特性 的 类 型 , 则 可 以 使 用 带 泛 型 参数 的 方法 : 


T GetCustomAttribute <T>(this …) where T : Attribute; 
此 方法 调用 起 来 是 最 简单 的 ,可 以 直接 返回 目标 特性 的 实例 。 但 是 如 果 使 用 以 下 方法 来 获 
取 自 定义 的 特性 实例 , 则 可 能 需要 进行 类 型 转换 ,因为 它 的 返回 类 型 为 Attribute( 特 性 类 的 
公共 基 类 ) 。 


Attribute GetCustomAttribute(this .…, Type attributeType); 


【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 一 个 特性 类 , 仅 应 用 于 类 上 面 。 
[AttributeUsage(AttributeTargets. Class, AllowMultiple = false)] 


public sealed class AliasNaneAttribute : Attribute 


{ 
public AliasNameAttribute(string aliasName) 
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{ 
Alias = aliasName; 
} 


public string Alias { get; } = null; 


注意 ; 特性 类 必须 是 Attribute 的 派生 类 ,或 者 间接 派生 类 。 


步骤 3: 声明 一 个 测试 类 ,并 在 类 上 应 用 上 述 特性 。 


[AliasName("order data")] 
public class CoreData 


. 


} 
步骤 4: 获取 CoreData 上 所 应 用 的 AliasNameAttribute。 


// 获取 与 类 型 相关 的 Type 对 象 
Type testType = typeof(CoreData); 
// 获取 特性 类 实例 
AliasNameAttribute attr = testType.GetCustomAttribute < AliasNameAttribute >(); 
// 输出 特性 类 的 属性 值 
if(attr != null) 
{ 
Console. WriteLine( $ "类 型 {testType. Name} 的 别名 是 :{attr. Alias}"); 
} 


步骤 5: 运行 应 用 程序 ,输出 结果 如 下 。 


类 型 CoreData 的 别名 是 :order_data 


12.2 Composition 


实例 313 ”安装 NuGet 包 一 一 System. Composition 


【导语 】 

Composition 技术 主要 用 于 程序 扩展 , 它 会 根据 协定 标识 主动 发 现 已 导出 的 类 型 ,并 把 
该 类 型 导入 和 组 合 到 特定 实例 上 ,这 样 应 用 程序 代码 就 能 使 用 这 些 导 入 的 类 型 了 。 

默认 情况 下 ,. NET Core 框架 不 包含 Composition 相关 的 API, 开发 人 员 需 要 通过 
NuGet 手动 安装 System. Composition 包 。 

本 实例 将 演示 在 项 目 中 安装 System. Composition 包 的 过 程 。 
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【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 在 Visual Studio 中 ,从 菜单 栏 中 依次 执行 “工具 ”~ NuGet 包 管理 器 ”一 “程序 
包 管 理 器 控制 台 ” 命 令 。 

步骤 3: 在 “程序 包 管理 器 控制 台 ” 窗 口中 输入 以 下 命令 ,然后 按 Enter 键 执行 。 


Install - Package System. Composition 


步骤 4: 等 待 安装 完成 。 
步骤 5: 程序 包 安装 完毕 后 ,在 “解决 方案 资源 管理 器 ”窗口 中 ,展开 项 目下 的 “依赖 项 ” 
结 点 ,可 以 看 到 安装 好 的 程序 包 以 及 它 所 依赖 的 其 他 程序 包 , 如 图 12-5 所 示 。 


120) 
nAttributedModel (1.2.0) 
ntion (1.2.0) 


Composition.TypedParts (1.2.0) 


图 12-5 System. Composition 以 及 其 依赖 项 


注意 : 程序 包 安 装 是 基于 项 目的 ,因此 在 新 建 的 项 目 中 如 果 需 要 用 到 System. Composition 
组 件 ,需要 手动 安装 。 


实例 314 ”导出 类 型 


【导语 】 

在 要 作为 扩展 组 件 的 类 上 应 用 ExportAttribute 后 ,该 类 便 被 标识 为 可 导出 类 型 , 即 它 
可 以 被 Composition 引擎 发 现 。ExportAttribute 类 有 两 个 很 重要 的 属性 : 

(1) ContractName 属性 : 类 型 协定 的 名 称 。 开 发 人 员 可 以 自 定义 该 名 称 ,必须 要 保证 
该 名 称 在 所 有 导出 类 型 中 的 唯一 性 ,否则 协定 名 称 就 失去 实际 用 途 了 (就 是 用 来 标识 类 型 协 
定 的 ) 。 

(2) ContractType 属性 : 协定 的 类 型 。 如 果 不 指 定 该 属性 ,默认 的 类 型 是 跟随 在 
ExportAttribute 之 后 的 类 型 ( 即 该 特性 所 应 用 的 目标 类 ) 。 

为 了 让 扩展 的 组 件 具 有 规律 性 (存在 相似 特征 ) ,以 便于 在 运行 时 灵活 使 用 ,通常 会 为 所 
有 待 导出 的 类 定义 一 个 共同 的 接口 ,然后 这 些 类 都 实现 这 个 接口 。 这 样 对 于 类 型 的 导入 者 
而 言 ,只 需要 认 准 这 个 通用 的 接口 ,而 不 必 考 虑 具体 的 实现 类 ,可 以 轻松 导入 并 调用 多 个 
类 型 。 


396 二 | .NET Core 实战 一 -手把手 教 你 掌握 380 个 精彩 案例 


集 


中 


【操作 流程 】 
为 了 使 演示 的 内 容 更 易于 理解 ,本 例 中 所 定义 的 导出 类 型 都 与 应 用 程序 在 同一 个 程序 


步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 定义 两 个 类 一 一 Car 和 Bike, 它 们 都 应 用 了 ExportAttribute。 


Export] 

public class Car 
{ 
public string Identity = > "小 汽车 "; 


Export] 

public class Bike 
{ 
public string Identity => "自行 车 "; 


应 用 ExportAttribute 时 , 既 没 有 指定 协定 的 名 称 , 也 没有 指定 协定 的 类 型 ,所 以 获取 导 


出 类 型 实例 时 ,所 指定 的 筛选 类 型 应 与 Car 类 或 Bike 类 相同 。 


月 


步骤 3: 查找 导出 的 类 型 ,并 获取 它们 的 实例 ,最 后 分 别 访问 它们 的 Identity 属性 。 


ContainerConfiguration config = new ContainerConfiguration(); 
// 在 当前 程序 集中 查找 类 型 
config. WithAssembly( Assembly. GetExecutingAssembly( )); 
// 创建 容器 
using(CompositionHost host = config.CreateContainer()) 
上 
// 获取 已 导出 的 类 型 实例 
Carc = host. GetExport< Car >(); 
Bike b = host.GetExport < Bike>(); 
Console. WriteLine( $ "c. Identity : {c.Identity}\nb. Identity : {b. Identity}"); 
} 


首先 要 创建 ContainerConfiguration 实例 ,对 Composition 操作 进行 配置 。 在 上 述 代码 


中 ,WithAssembly 方法 用 于 指定 查找 导出 类 型 的 程序 集 , 本 例 为 当前 程序 集 。 然 后 调用 
CreateContainer 方法 创建 用 于 获取 导出 类 型 实例 的 CompositionHost 对 象 。 再 通过 
GetExport 方法 就 可 以 获取 导出 类 型 的 实例 。 导 出 类 型 在 实例 化 时 ,Composition 组 件 会 调 
日 它 的 公共 无 参数 构造 函数 ,所 以 要 导出 的 类 中 必须 包含 无 参数 的 公共 构造 器 。 


步骤 4: 运行 应 用 程序 ,输出 内 容 如 下 。 


c. Identity : 小 汽车 
b. Identity : 自行 车 
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注意 : 本 实例 的 导出 类 型 在 设计 上 并 不 合理 ,只 是 为 了 演示 。 推 荐 的 做 法 是 定义 一 个 接口 ， 
并 在 接口 中 公开 Identity 属性 ,然后 Car 和 Bike 类 都 实现 这 个 接口 。 这 样 在 获取 导 
出 类 型 时 ,只 需要 提供 该 接口 作为 查找 条 件 即 可 。 


实例 315 ”通过 协定 来 约束 导出 类 型 


【导语 】 

本 实例 将 演示 通过 指定 唯一 命名 与 类 型 协定 来 标识 导出 类 型 ,这 样 做 既 能 保证 导出 的 
类 型 具有 唯一 的 标识 ,又 可 以 保持 兼容 性 。 本 例 中 所 有 导出 的 类 都 会 实现 IPlayer 接口 。 
尽管 被 导出 的 类 型 都 被 约束 为 IPlayer, 但 每 一 个 导出 的 类 型 都 设置 了 协定 名 称 ( 确 保 不 会 
重复 出 现 ) 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 安装 System. Composition NuGet 包 。 

步骤 3: 引入 以 下 命名 空间 。 


using System; 

using System. Composition; 

using System. Composition. Hosting; 
using System. Reflection; 


步骤 4: 声明 IPlayer 接口 ,作为 导出 类 型 的 公共 规范 。 


public interface IPlayer 
{ 

void PlayTracks(); 
} 


步骤 $: 定义 两 个 实现 IPlayer 接口 的 类 ,并 且 应 用 ExportAttribute。 


[Export("gen_pl", typeof(IPlayer))] 
public class GenPlayer : IPlayer 
| public void PlayTracks() 
| Console. WriteLine(" 在 普通 播放 器 上 播放 音乐 "); 
| } 


[Export("pro_pl", typeof(IPlayer))] 
public class Proplayer : IPlayer 
{ 

public void PlayTracks() 
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集 


ImportAttribute 的 
则 可 以 导入 多 个 类 型 实例 ,此 时 


{ 
Console. WriteLine(" 在 专业 播放 器 上 播放 音乐 "); 
} 
’ 


步骤 6: 回 到 Main 方法 中 ,获取 当前 正在 执行 的 程序 集 。 


Assembly currAss = Assembly.GetExecutingAssembly(); 


步骤 7: 创建 ContainerConfiguration 实例 ,设置 导出 类 型 的 查找 范围 位 于 当前 程序 
中 。 


ContainerConfiguration config = new ContainerConfiguration() 
.WithAssembly(currAss); 


步骤 8: 创建 Composition 容器 ,并 获取 导出 类 型 的 实例 。 


using(CompositionHost host = config.CreateContainer()) 
{ 
IPlayer pl 
IPlayer p2 
} 
在 调用 GetExport 方法 时 ,需要 传递 每 个 导出 类 型 所 对 应 的 协定 名 称 。 
步骤 9: 分 别 调用 两 个 对 象 实例 的 PlayTracks 方法 。 


st. GetExport < IPlayer >("gen_p1"); 


= ho 
= host. GetExport < IPlayer >("pro_p1"); 


using(CompositionHost host = config.CreateContainer()) 
{ 


pl.PlayTracks( ); 
p2. PlayTracks(); 


} 

步骤 10: 运行 应 用 程序 ,会 看 到 以 下 输出 结果 。 
在 普通 播放 器 上 播放 音乐 

在 专业 播放 器 上 播放 音乐 

实例 316 导入 多 个 类 型 

【导语 】 


Composition 技术 支持 将 类 型 导 人 到 某 个 类 的 属性 (或 方法 参数 ) 中 。 应 用 了 


在 导入 类 型 时 会 自动 填充 该 属性 。 
本 实例 中 ,以 IAnimal 接口 作为 类 型 协定 的 基础 ,有 三 个 类 实现 该 接口 ,并 标记 为 导出 


类 型 。 然 后 定义 SomeAnimalSamples 类 ,并 公开 AnimalList 


属性 只 可 以 导入 单个 类 型 实例 ,而 应 用 了 ImportManyAttribute 的 
属性 一 般 声明 为 IEnumerable< T > 类 型 ,Composition 容器 


属性 


属性 ,其 类 型 为 IEnumerable 
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<IAnimal>。 最 后 用 Composition 容器 将 导入 的 类 型 实例 填充 AnimalList 集合 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 定义 IAnimal 接口 ,公开 两 个 属性 。 


public interface IAnimal 

{ 
string Name { get; } 
string Family { get; } 


步骤 3: 定义 三 个 实现 IAnimal 接口 的 类 ,并 标识 为 导出 类 型 。 


Export(typeof(IAnimal))] 

public class FelisCatus : IAnimal 
{ 
public string Name => "家 猫 "; 
public string Family => " 猫 科 "; 


Export (typeof (IAnimal))] 
public class SolenopsisInvictaBuren : IAnimal 
{ 
public string Name => "红火 蚁 "; 
public string Family =>" 蚁 科 "; 
' 


[Export (typeof (IAnimal))] 
public class HeliconiusMelpomene : IAnimal 
{ 
public string Name => " 红 带 袖 蝶 "; 
public string Family => " 凤 蝶 科 "; 
} 


步骤 4: 定义 SomeAnimalSamples 类 ,并 把 AnimalList 标记 为 可 导入 多 个 类 型 。 


class SomeAnimalSamples 
{ 
[ImportMany] 
public IEnunerable < IAnimal > AnimalList { get; set; } 


注意 : 记得 要 在 属性 上 应 用 ImportManyAttribute, 因 为 Composition 在 组 合 类 型 时 会 查找 
该 特性 。 
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步骤 5: 回 到 Main 方法 ,将 当前 程序 集 作为 Composition 搜索 导出 类 型 的 范围 。 


Rssenbly currentAssembly = Assembly. GetExecutingAssembly(); 
ContainerConfiguration config = new ContainerConfiguration() 
.WithAssembly(currentAssembly); 


步骤 6: 创建 Composition 容器 ,并 将 导入 的 类 型 组 合 到 SomeAnimalSamples 对 象 的 
AnimalList 属性 中 。 


SomeAnimalSamples samples = new SomeAnimalSamples(); 
using(CompositionHost container = config.CreateContainer()) 
{ 


container. SatisfyInports(samples); 


} 
步骤 7: 测试 访问 导入 的 类 型 实例 。 


foreach (IAnimal an in samples. AnimalList) 
{ 


Console. WriteLine( $ "Nane: {an. Name}\nFamily: {an. Family}\n"); 

} 图 12-6 访问 导入 后 的 
De a a 三 个 类 型 实例 

步骤 8: 运行 应 用 程序 ,得 到 如 图 12-6 所 示 的 结果 。 和 


实例 317 导出 元 数据 


【导语 】 

在 导出 类 型 的 时 候 ,可 以 同时 将 元 数据 导出 。 元 数据 可 以 理解 为 一 系列 附加 信息 ,这 些 
数据 与 类 型 相关 但 不 参与 执行 ,仅仅 对 类 型 做 出 额外 的 描述 。 在 要 导出 的 类 型 上 应 用 
ExportMetadataAttribute 可 以 添加 要 导出 的 元 数据 , 它 包含 两 个 值 : Name 是 元 数据 字段 
的 名 称 , 类 型 为 字符 串 ; Value 是 与 字段 对 应 的 值 ,类 型 为 object, 即 每 条 元 数据 的 结构 类 似 
于 字典 。 要 指定 多 条 元 数据 ,可 以 在 导出 的 类 型 上 应 用 多 个 ExportMetadataAttribute。 

在 导入 时 ,可 以 使 用 Lazy<T，TMetadata > 类 型 的 对 象 来 接收 导入 的 类 型 与 元 数据 。 
Lazy 类 提供 了 一 种 机 制 一 一 类 型 可 以 延迟 初始 化 , 即 当 Value 属性 被 访问 时 才 会 调用 工 类 
型 的 构造 器 。TMetadata 表示 导入 的 元 数据 ,一 般 情况 下 ,可 以 使 用 IDictionary < string， 
object > 类 型 来 接收 元 数据 ,也 可 以 使 用 一 个 自 定义 的 类 来 接收 ( 带 无 参数 构造 函数 的 类 )。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 要 导出 的 类 型 ,并 指定 两 条 元 数据 记录 。 

[Export] 

[ExportMetadata( "Ver", "1.0")] 


[ExportMetadata( "Publisher", "Mike")] 
public class Test 
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public void Run() 
{ 
Console. WriteLine("Run 方法 被 调用 "); 
} 
} 


步骤 3: 在 Program 类 中 ,声明 一 个 属性 ,用 于 接收 导入 的 类 型 。 


[Import] 
Lazy< Test, IDictionary< string, object >> ComposObject { get; set; } 


步骤 4: 创建 Composition 容器 ,然后 合并 导入 的 类 型 。 


ContainerConfiguration cfg = new ContainerConfiguration ( ). WithAssembly ( Assembly. 
GetExecutingAssembly()); 
Progran p = new Program(); 
using(CompositionHost container = cfg.CreateContainer()) 
* 
container. SatisfyImports(p); 


} 
步骤 5; 访问 已 导入 的 Test 实例 。 


Test 七 = p.ComposObject. Value; 
// 调用 导入 的 实例 
t. Run() 


步骤 6: 获取 导入 的 元 数据 。 


Cprogramfil. — ODO Xx 


IDictionary < string, object > metas = p. ComposObject. 
Metadata; ie: 1.0 


lisher, value: Jike 


foreach(KeyValuePair < string, object > kv in metas) 


{ 


Console. Writebine ( $ " key: {kv. Key}, value: {kv. 图 12-7 输出 导入 的 元 数据 
Value}"); 


} 
步骤 7: 运行 应 用 程序 ,控制 台 输出 结果 如 图 12-7 所 示 。 
实例 318 ”使 用 自 定义 类 型 来 接收 野人 的 元 数据 


【导语 】 

导入 的 元 数据 ,不 仅 可 以 使 用 IDictionary < string，object > 类 型 来 接收 ,还 可 以 使 用 自 
定义 的 类 来 接收 ,此 自 定义 类 需要 满足 两 个 条 件 : 

(1) 包含 公共 的 无 参数 构造 函数 。 因 为 在 填充 元 数据 时 ,类 实例 由 Composition 自动 
创建 ,而 不 是 从 代码 中 显 式 调用 构造 函数 。 

(2) 该 类 中 的 属性 名 称 必须 与 导出 的 元 数据 的 Name 属性 匹配 ,而 且 是 区 分 大 小 写 的 。 
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【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 。 
步骤 2: 声明 要 导出 的 类 型 ,并 附加 元 数据 。 


[Export] 

[ExportMetadata( "MaxTracks", 15), 
ExportMetadata( "Skin", "blue")] 

public class FunMusicPlayer 


和 


public void Play() => Console.WriteLine(" 正 在 播放 音乐 … … "ys 
} 


步骤 3: 定义 一 个 类 ,用 于 在 导入 时 存储 元 数据 。 


class ImportMetaData 
{ 


public int MaxTracks { get; set; } 
public string Skin { get; set; } 
} 


在 导出 类 型 时 ,指定 的 元 数据 名 称 分 别 为 MaxTracks 和 Skin, 所 以 ImportMetaData 类 
的 属性 名 称 必须 与 之 一 一 对 应 。 
步骤 4: 在 Program 类 中 公开 一 个 属性 ,用 于 引用 导入 的 类 型 。 


[Import] 
public Lazy < FunMusicPplayer, InportMetaData> CurPlayer { get; set; } 


步骤 5: 实例 化 Composition 容器 ,执行 导入 操作 。 


ContainerConfiguration cfg = new ContainerConfiguration ( ). WithAssembly (Assembly. 
GetExecutingAssembly()); 
Progran p = new Program(); 
using(CompositionHost host = cfg.CreateContainer()) 
{ 
host. SatisfyImports(p); 
} 


步骤 6: 输出 已 导入 的 元 数据 。 


ImportMetaData meta = p.CurPlayer. Metadata; 
Console. WriteLine( $ "{nameof (ImportMetaData. MaxTracks)}: 
{meta. MaxTracks} \n{nameof ( ImportMetaData. Skin)}: {meta. Skin}"); 


步骤 7: 运行 应 用 程序 ,控制 台 输 出 内 容 如 下 。 


MaxTracks: 15 
Skin: blue 


| 
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实例 319 封装 元 数据 


【导语 】 
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若 元 数据 的 条 目 比 较 多 ,使 用 多 个 ExportMetadataAttribute 对 象 来 指定 元 数据 会 显得 


比较 麻烦 。 这 时 候 可 以 用 一 个 类 来 封装 元 数据 ,但 要 注意 以 下 两 点 : 


(1) 封装 元 数据 的 类 需要 应 用 MetadataAttributeAttribute 进行 标注 。 
(2) 这 个 封装 类 应 当 从 Attribute 类 派生 。 因 为 导出 类 型 的 元 数据 是 附加 信息 ,以 特性 


的 形式 应 用 到 导出 类 型 的 定义 上 
【操作 流程 
步骤 1: 定义 协定 接口 。 


public interface ITest 
void RunTask( ); 


} 
步骤 2: 定义 元 数据 的 封装 类 。 


[MetadataAttribute] 

class CustMetadataAttribute : Attribute 

{ 
public string Ruthor { get; set; } 
public string Description { get; set; } 
public int Version { get; set; } 


public CustMetadataAttributel( string author, string desc, int ver) 


{ 
Author = author; 
Description = desc; 


Version = ver; 


步骤 3: 定义 两 个 用 于 导出 的 类 ,它们 都 实现 ITest 接口 ,并 且 应 用 定义 好 的 


CustMetadataAttribute 来 指定 元 数据 。 


[EpoerEttSpeeE(timest)] 
[custMetadata( "Tom"，"debug version", 1)] 
public class TestWork_V1 : ITest 
{ 
public void RunTask() 
{ 
Console. WriteLine(" 这 是 版 本 1"); 
3 
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[Export(typeof(ITest))] 
[CustMetadata( "Jack", "release version", 2)] 
public class TestWork_V2 : ITest 
{ 

public void RunTask() 

{ 

Console. WriteLine(" 这 是 版 本 2"); 

} 

} 


步骤 4: 定义 一 个 新 类 ,用 于 引用 导入 的 类 型 与 元 数据 。 


public class TestCompos 
{ 


[ImportMany] 

public IEnumerable < Lazy < ITest, IDictionary < string, object >>> ImportedComponents { 
get; set; } 
} 


步骤 5: 加 载 要 查找 导出 类 型 的 程序 集 。 


Assembly comAss = Assembly. LoadFrom("CustExportProj.d11"); 
ContainerConfiguration config = new ContainerConfiguration().WithAssembly(comAss); 


步骤 6: 创建 Composition 容器 ,并 把 类 型 导入 到 刚 定义 的 TestCompos 实例 中 。 


TestCompos cps = new TestCompos(); 
using (var host = config.CreateContainer()) 
{ 
host. SatisfyImports(cps); 
} 


步骤 7: 获取 导入 的 元 数据 ,然后 调用 导入 的 类 型 。 


foreach (var c in cps. ImportedComponents) 
{ 
ITest obj = c.Value; 
IDictionary< string, object > meta = c.Metadata; 
Console. Write( "元 数据 :\n"); 
foreach(var it in meta) 
{ 
Console. Write( $ "{it. Key}: {it. Value} \n"); 
于 
Console.Write( $ "调用 {obj. GetType().Name} 实例 :\n"); 
obj. RunTask( ); 
Console. Write("\n\n"); 


人 
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步骤 8: 运行 应 用 程序 ,输出 结果 如 图 12-8 所 示 。 


图 12-8 输出 元 数据 与 导入 对 象 的 调用 结果 


实例 320 ”用 抽象 类 来 充当 协定 类 型 


【导语 】 

Composition 不 仅 支持 以 接口 作为 协定 类 型 ,还 可 以 使 用 抽象 类 。 接 口 和 抽象 类 都 具 
有 规范 类 型 结构 的 作用 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 一 个 抽象 类 ,作为 导出 类 型 的 公共 基 类 。 


public abstract class GenBase 
{ 
public abstract Guid ID { get; } 
public abstract string Title { get; } 
public abstract void ConnectEndpoint(); 
} 


步骤 3: 定义 两 个 导出 类 型 ,它们 都 实现 GenBase 抽象 类 。 


[Export (typeof (GenBase)) ] 
public class CompoFirst : GenBase 
{ 
public override Guid ID => Guid. NewGuid( ); 
public override string Title => "test component 1"; 
public override void ConnectEndpoint() 
{ 
Console. WriteLine("Connecting to DWO DB …"); 


} 
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[Export(typeof (GenBase))] 

public class CompoSecond : GenBase 

{ 
public override Guid ID => Guid. NewGuid( ); 
public override string Title => "test component II"; 
public override void ConnectEndpoint( ) 


{ 
Console. WriteLine("Connecting to RLS DB -… "); 


} 
步骤 4: 配置 ContainerConfiguration 实例 。 


Assembly curAssembly = Assembly. GetExecutingAssembly(); 
ContainerConfiguration config = new ContainerConfiguration(); 
config. WithAssenbly(curAssembly); 


步 又 5: 创建 Composition 容器 ,并 调用 导出 的 类 型 实例 。 


using(var host = config.CreateContainer()) 


{ 
IEnumerable< GenBase > objs = host. GetExports < GenBase >(); 


foreach (GenBase o in objs) 
{ 
Console. Write("ID: {0}\nTitle: {1}\n", o.1D, o.Title); 
Console. WriteLine(" 调 用 {0} 的 {1} 方法 :"，o. GetType().Name, nameof 
(GenBase. ConnectEndpoint)); 
o. ConnectEndpoint(); 
Console. Write("\n"); 


} 
步骤 6: 运行 应 用 程序 ,输出 结果 如 图 12-9 所 示 。 


国 C\Program Files\dotnet\dotnet. 


-d ib-fe6c7 


图 12-9 以 抽象 类 来 充当 协定 类 型 


加 密 算 法 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。 单 向 加 密 ; 
， 双向 加 密 。 


13.1 单 向 加 密 


实例 321 计算 输入 字符 串 的 MDS 值 

【导语 】 

在 哈 希 算法 中 ,MD5 是 最 为 常见 的 ,多 用 于 校 验 密码 ,一 般 的 做 法 是 , 先 用 密码 字符 串 
计算 出 其 MD5 值 ,再 把 该 MD5 值 转换 为 字符 串 , 存 进 数据 库 。 校 验 时 重新 计算 输入 密码 
的 MD5 值 ,再 与 数据 库 中 存储 的 值 做 比较 ,如 果 相 同 则 表示 密码 正确 。 

本 实例 将 对 输入 的 文本 进行 MD5 计算 ,然后 输出 计算 得 到 的 哈 希 码 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 获取 用 户 的 键盘 输入 内 容 。 

Console. WriteLine(" 请 输入 文本 :"); 


string input = Console.ReadLine() 


步骤 3: 计算 输入 内 容 的 MD5 值 。 


byte[ ] data = Encoding.UTF8.GetBytes(input); 
MD5 md5 = MD5.Create(); 
byte[ ] result = md5.ConputeHash(data); 


注意 : 加 密 算法 都 是 针对 字 节 进行 计算 的 ,因此 在 计算 之 前 ,要 把 计算 内 容 转换 为 字 节 
数组 。 
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步骤 4: 输出 计算 结果 。 


Console. WriteLine("\n 计算 结果 :"); 
foreach(byte b in result) 
{ 

Console. Write(" 0x{0:x2}", b); 
} 


步骤 5: 运行 应 用 程序 ,结果 如 图 13-1 所 示 。 


实例 322 ”使 用 SHA1 算法 校 验 文件 


【导语 】 


CProgram., 一 口 Xx 


图 13-1 


输入 文本 的 MD5 值 


对 于 数量 不 是 很 大 的 情况 ,例如 一 般 文件 ,可 以 使 用 SHA1 算法 校 验 。 校 验 可 以 用 在 
两 种 情况 中 : 一 是 通过 网 络 传输 文件 后 ,为 了 检查 下 载 的 文件 是 否 出 现 数据 损失 ,可 以 将 源 


文件 的 哈 希 码 与 下 载 后 文件 的 哈 希 码 作 比 较 , 如 果 两 个 文件 的 哈 希 码 相同 ,表明 文件 已 经 正 
确 传输 ; 另 一 种 情况 是 可 以 通过 哈 希 码 来 检查 两 个 文件 的 内 容 是 否 相 同 ( 可 用 于 查找 重 


变 件 下 


由 


本 实例 将 首先 创建 一 个 文件 , 写 和 人 随机 字 节 流 ,然后 将 文件 进行 复制 ,最 后 用 SHA1 算 


法 分 别 计算 两 个 文件 的 哈 希 码 。 
【操作 流程 】 
步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 
步骤 2: 创建 新 文件 , 写 入 随机 字 节 。 


using(FileStrean fsin = File.Create("verl. smp")) 


{ 
byte[ ] buffer = new byte[256]; 
Random rand = new Random(); 
for(int x = 0; x<50; xt+) 
{ 
rand. NextBytes(buffer); 
fsin. Write(buffer); 


} 
步骤 3: 复制 刚 创建 的 文件 。 


File.Copy("verl. smp", "ver?2. smp", true); 


步骤 4: 使 用 SHA1 算法 ,分 别 计算 这 些 文件 的 哈 希 码 。 


string curdir = Directory. GetCurrentDirectory(); 


string[ ] files = Directory. GetFiles(curdir, "* .smp"); 


SHA1 sha = SHR1.Createl ) ; 
foreach (string f in files) 
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using(FileStream fs = File.OpenRead(f)) 

{ 
byte[ ] result = sha.ComputeHash(fs); 
Console. WriteLine(" 文 件 {0} 的 哈 希 码 :"，Path. GetFileNane(f)); 
StringBuilder bd = new StringBuilder(); 
foreach(byte b in result) 

bd. AppendFormat("{0:x2}", b); 

} 
Console. Write(bd + "\n\n"); 

} 

} 


Sle Dosetly 

ComputeHash 方法 有 多 个 重 载 , 既 可 以 传 
入 字 节 数组 进行 计算 ,也 可 以 直接 使 用 流 对 象 。 
该 算法 的 计算 结果 是 以 字 节 序列 表示 的 ,上 述 代 
码 将 计算 结果 转换 为 十 六 进 制 形式 的 字符 串 。 

步骤 5: 运行 应 用 程序 ,从 输出 结果 可 以 看 
到 ,复制 后 的 文件 与 原来 的 文件 相同 ,因为 它们 
具有 相同 的 喻 希 码 ,如 图 13-2 所 示 。 


图 13-2 相同 的 文件 产生 相同 的 哈 希 码 


13.2 双向 加 密 


实例 323 ”使 用 AES 算法 加 密 和 解密 文本 


【导语 】 

AES 属于 双向 加 密 算 法 ( 即 数据 被 加 窗 后 可 以 解密 ) ,通常 需要 两 个 重要 元 素 : 密 钥 
(Key) 和 初始 向 量 (IV) ,必须 提供 与 加 密 相同 的 Key 和 IV 才能 顺利 完成 解密 。 双 向 加 密 
算法 需要 CryptoStream 类 作为 数据 内 容 的 读 写 中 介 ,CryptoStream 对 象 并 不 表示 特定 的 
流 实例 ,因此 它 需 要 基础 流 ( 例 如 内 存 流 ,文件 流 等 )。 

本 实例 演示 了 使 用 AES 算法 加 密 文本 内 容 , 然 后 对 加 密 后 的 数据 进行 解密 ,还 原文 本 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 EncryptData 方法 ,接收 密 钥 ,初始 向 量 和 待 加 密 的 文本 ,并 返回 加 密 后 的 
字 节 数组 。 

static byte[ ] EncryptData(byte[ ] key，byte[ ] iv, string content) 


{ 
byte[ ] res = null; 
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using(NMes aes = Res.Create()) 


{ 
using(MemoryStream msbase = new MemoryStrean()) 


人 


using(CryptoStrean cstr = new CryptoStream(msbase, aes. CreateEncryptor(key, iv), 
CryptostreamMode. Write)) 


{ 
using(StreamWriter writer = new StreamWriter(cstr)) 
’ 
writer. Write(content); 
} 


} 
res = msbase.ToArray(); 
¥ 
} 
return res; 


要 


在 实例 化 CryptoStream 类 时 ,CryptoStreamMode 的 取 值 是 很 关键 的 。 上 述 方法 中 , 待 
加 密 的 数据 是 通过 CryptoStream 实例 写 入 的 ,最 终 把 加 密 后 的 数据 写 到 内 存 流 中 ,所 以 此 
处 mode 参数 应 使 用 Write 值 。 

步骤 3: 定义 DecryptData 方法 ,进行 解密 操作 ,还 原 字 符 串 。 


static string DecryptData(byte[ ] key, byte[] iv，byte[ ] dataContent) 
{ 
string res = null; 
using(Res aes = Res.Create() ) 
{ 
using(MemoryStream ms = new MemoryStream(dataContent)) 
{ 
ICryptoTransform trf = aes.CreateDecryptor(key, iv); 
using(CryptoStrean cstream = new CryptoStream(ms, trf, CryptoStreamMode. Read)) 


{ 
using(StreamReader reader = new StreamReader(cstream)) 
, 
res = reader. ReadToEnd(); 
} 
} 


} 
} 


return res; 


} 

上 述 代 码 中 ,用 已 加 密 的 字 节 数组 创建 了 内 存 流 ,CryptoStream 实例 以 内 存 流 为 基础 ， 
先 从 内 存 流 中 读 入 已 加 密 的 数据 ,然后 进行 解密 计算 ,最 后 传 到 StreamReader 对 象 中 被 读 
出 来 。 因 此 在 实例 化 CryptoStream 类 时 ,mode 参数 应 该 取 Read 值 。 
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步骤 4: 回 到 Main 方法 中 ,声明 相关 的 变量 。 


// 待 加 密 的 内 容 

string msgToEnc = "实验 文本 "; 
// 加 密 用 的 密 钥 

byte[ ] key; 

// 初始 向 量 

byte[ ] iv; 


步骤 5: 在 本 例 中 ,分 别 调用 Aes 类 的 GenerateKey 方法 和 GenerateIV 方法 ,将 随机 产 
生 key( 密 钥 ) 和 iv( 初 始 向 量 )。 


using(Res aes = Res.Create()) 
{ 

aes. GenerateKey( ); 

key = aes. Key; 

aes. GenerateIV(); 

iv = aes.IV; 


} 
步骤 6: 下 面 代码 对 文本 进行 加 密 。 


byte[ ] encData = EncryptData(key, iv, msgToEnc ) ; 

Console. WriteLine(" 原 文本 :{0}"，msgToEnc) 7 

Console. WriteLine ( " 加 密 后 : {0}"，BitConverter. ToString 
(encData) ); 


步骤 7: 接 下 来 进行 解密 ,恢复 文本 信息 。 


图 13-3 用 AES 算法 加 
密 和 解密 文本 


string decMsg = DecryptData(key, iv, encData); 
Console. WriteLine( "解密 后 :{0}"，decMsg); 


步骤 8: 运行 应 用 程序 ,效果 如 图 13-3 所 示 。 
实例 324 不 需要 初始 向 量 的 AES 加 密 


【导语 】 

双向 加 密 (对 称 加 密 ) 的 基 类 (SymmetricAlgorithm 类 ) 公 开 了 一 个 Mode 属性 ,类 型 为 
CipherMode 枚 举 ,默认 取 值 为 CBC。 由 于 AES 算法 是 SymmetricAlgorithm 的 子 类 ,所 以 
在 加 密 与 解密 时 都 需要 提供 匹配 的 密 钥 与 初始 向 量 。 若 将 Mode 属性 改 为 ECB, 在 加 /解密 
时 则 可 以 忽略 初始 向 量 , 仅 使 用 密 钥 即 可 ,但 是 ECB 模式 存在 一 定 的 安全 隐患 ,建议 用 于 加 
密 一 些 简 单 的 ,不 太 重 要 的 文本 信息 。 

本 实例 将 使 用 ECB 模式 的 AES 算法 来 加 密 与 解密 通过 键盘 输入 的 文本 内 容 。 

【操作 流程 】 

步骤 1: 新 建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 定义 GenerateKey 方法 ,用 于 生成 随机 密 钥 (Key) 。 
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static byte[ ] GenerateKey() 
# 


byte[ ] theKey = null; 
using(Res aes = Res.Create()) 
{ 
aes. GenerateKey( ); 
theKey = aes. Key; 
} 
return theKey; 


¥ 
步骤 3: 定义 EncryptoText 方 法 对 输入 的 文本 进行 加 密 , 并 返回 加 密 后 的 字 节 数组 。 


static byte[ ] EncryptoText(byte[ ] key, string text) 
{ 
byte[ ] resData = null; 
using(Res aescrpt = Aes.Create()) 
{ 
aescrpt. Mode = CipherMode. ECB; 
using(MemoryStream mmrStr = new MemoryStrean()) 
{ 
ICryptoTransform cf = aescrpt. CreateEncryptor(key, null); 
using(CryptoStrean cs = new CryptoStrean(mmrStr, cf, CryptoStreamMode. Write) ) 
{ 
using(StreamWriter writer = new StreamWriter(cs)) 
{ 


writer. Write( text); 


} 
resData = mmrStr.ToArray(); 


} 
return resData; 


} 
步骤 4: 定义 DecryptoText 方法 ,解密 已 经 加 密 的 文本 。 


static string DecryptoText(byte[ ] key, byte[ ] data) 
{ 
string _text = null; 
using(Res aescrypt = Aes.Create()) 
{ 
aescrypt. Mode = CipherMode. ECB; 
using(MemoryStream mmstream = new MenoryStream(data) ) 
{ 
ICryptoTransform cf = aescrypt.CreateDecryptor(key, null); 
using(CryptoStrean cs = new CryptoStrean(mmstream, cf, CryptoStreamMode. Read)) 
{ 
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using(StreamReader reader = new StreamReader(cs)) 
{ 

_text = reader. ReadTognd(); 
} 


} 
} 


return _text; 


注意 : 在 解密 时 ,创建 Aes 实例 后 ,要 设置 其 Mode 属性 为 ECB, 使 其 与 加 密 时 的 模式 匹配 ， 
否则 无 法 正常 解密 。 


步骤 $: 运行 应 用 程序 ,控制 台 输 出 内 容 如 图 13-4 所 示 。 


C2-DB-77-96-1F-5B-ED-38-52-CD-11-4B-5D 
解密 后 的 文本 ， 独 坐 幽 复 里 


13-4 基于 ECB 模式 的 加 密 


实例 325 用 RSA 算法 加 密 和 解密 数据 


【导语 】 

RSA 算法 也 需要 密 钥 (Key) 来 加 密 和 解密 数据 ,但 是 该 算法 使 用 的 是 两 个 密 钥 一 一 公 
钥 与 私 钥 。 公 钥 用 于 加 密 数 据 , 但 不 能 解密 数据 ,因此 公 钥 可 以 对 外 公开 (例如 可 以 通过 网 
络 传 输 给 他 人 使 用 ); 而 私 钥 是 不 能 公开 的 ,加 密 后 的 数据 需要 用 私 钥 解 密 。 

RSA 算法 可 以 用 来 对 网 络 数据 进行 保护 ,毕竟 以 明文 传输 数据 很 容易 被 他 人 截获 而 造 
成 信息 泄露 。 例 如 ,A 与 B 进行 通信 ,A 可 以 将 自己 的 公 钥 告诉 BB, 同样 BB 也 可 以 将 自己 的 
公 钥 告诉 A, 但 私 钥 由 A、B 各 自 保 密 , 不 能 公开 。 对 话 的 时 候 ,A 使 用 B 的 公 钥 对 消息 加 
密 , 然 后 发 送 给 B,B 收 到 消息 后 用 自己 的 私 钥 解密 ,就 能 看 到 消息 内 容 了 ; 同 理 , 如 果 B 要 
向 A 发送 消息 ,就 要 用 A 的 公 钥 将 消息 加 密 然后 发 送 给 A,A 收 到 消息 后 用 自己 的 私 钥 解 
密 , 就 能 看 到 消息 内 容 了 。 

【操作 流程 】 

步骤 1: 新建 一 个 控制 台 应 用 程序 项 目 。 

步骤 2: 声明 相关 的 变量 。 


string sampleTest = "The Dotnet Core App"; 
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byte[ ] key = null; 
byte[ ] encryptData = null; 


sampleTest 是 用 于 对 加 密 和 解密 进行 测试 的 字符 串 ,encryptData 表示 被 加 密 后 的 
数据 。 
步骤 3: 对 示例 字符 串 进行 加 密 。 
using (RSACryptoServiceProvider rsa = new RSACryptoServiceProvider()) 
{ 
// 导出 公 钥 与 私 钥 
key = rsa. ExportCspBlob(true); 


encryptData = rsa. Encrypt(Encoding. ASCII. GetBytes( sampleTest ), RSAEncryptionPadding. Pkcs1); 
} 
因为 稍 后 要 对 数据 进行 解密 ,所 以 需要 调用 ExportCspBlob 方法 将 密 钥 导出 备用 。 
ExportCspBlob 方法 需要 一 个 bool 类 型 的 参数 ,表示 是 否 导出 私 钥 。 如 果 不 导 出 私 钥 , 后 
面 就 无 法 解密 数据 了 ,所 以 此 处 应 该 设 定 为 true。 
步骤 4: 解密 数据 。 
using(RSACryptoServiceProvider rsa = new RSACryptoServiceProvider()) 
{ 
// 导入 公 钥 与 私 钥 
rsa. ImportCspBlob( key); 
byte[ ] bf = rsa.Decrypt(encryptData, RSAEncryptionPadding. Pkcs1); 
string restoreStr = Encoding.ASCII.GetString(bf); 
Console. Write( $ "解密 后 的 字符 串 :\n{restoreStr}"); 
} 
调用 ImportCspBlob 方法 后 ,会 导入 刚刚 导出 的 公 钥 和 私 钥 。 
步骤 5: 运行 应 用 程序 ,效果 如 图 13-5 所 示 。 


Caprogramfiles\dotn.. — DO Xx 


图 13-5 RSA 算法 加 密 与 解密 


第 三 篇 ，ASP.NET Core 


ASP.NET Core 以 . NET Core 框架 为 基础 ,是 专 为 Web 开发 而 推 
出 的 扩展 框架 ,也 是 学 习 . NET Core 编程 的 一 个 重要 模块 。 通 过 学 习 
本 简 , 读 者 将 掌握 以 下 内 容 : 

。 Web Host 与 应 用 程序 的 初始 化 配置 ; 

。 中 间 件 的 运用 与 开发 ; 

。 服务 与 依赖 注入 ; 

。 MVC 模型 的 常用 技巧 ; 

。 管理 应 用 程序 配置 (配置 文件 、 环 境 变量 .选项 类 ); 

。 Entity Framework (EF) Core( 包 括 实体 模型 的 构建 与 迁移 、 运 

行 时 创建 数据 库 等 ) 。 


:和 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。 Web 主机 配置 ; 
»。 Startup; 


。 启动 环境 。 
14.1 Web 主 机 配置 


实例 326 ”使 用 默认 配置 创建 Web 主机 

【导语 】 

WebHost 是 一 个 静态 类 , 它 公 开 了 一 系列 简便 的 方法 ,可 以 使 用 各 项 默认 配置 参数 创 
建 Web 主机 ,其 中 用 得 较 多 的 是 CreateDefaultBuilder 方法 。CreateDefaultBuilder 方法 一 
般 使 用 默认 的 配置 来 创建 WebHostBuilder 实例 ,这 些 默认 的 配置 包括 : 

(1) 使 用 内 置 的 Kestrel 服务 器 组 件 ,能够 使 Web 应 用 在 进程 中 独立 运行 。 

(2) 使 用 JIS 交互 。IIS 将 作为 反 向 代理 端 ,将 HTTP 请 求 转发 到 Web 应 用 程序 。 

(3) 将 应 用 程序 的 当前 目录 作为 Web 内 容 的 根 目 录 。 

(4) 加 载 appsettings. json 或 appsettings. < 启动 环境 >. json 文件 来 对 应 用 程序 进行 


配置 。 

(5) 加 载 环境 变量 和 命令 行 参数 。 

(6) 记录 日 志 , 并 在 控制 台 窗 口 和 Visual Studio 的 “调试 "窗口 中 输出 日 志 信 息 。 
调用 CreateDefaultBuilder 方法 并 返回 WebHostBuilder 实例 ,接着 调用 该 实例 的 Build 


方法 ,就 能 创建 WebHost 实例 了 ,最 后 调用 Run 扩展 方法 启动 Web 服务 器 , Web 应 用 程序 
开始 执行 。 


【操作 流程 】 


步骤 1: 在 Visual Studio 开发 环境 中 ,依次 执行 菜单 "文件 "新建 "一 “项目 ”命令 , 打 
开 “ 新 建 项 目 ” 窗 口 。 


步骤 2: 在 .NET Core 应 用 分 支 下 找到 “ASP. NET Core Web 应 用 程序 ”, 如 图 14-1 所 示 。 
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NET Core) 


(NET Core) 


ASPINET Core Web 应 用 得 序 Visual cf 


未 找到 你 要 喜 拭 的 内 容 ? 


名 i(N) WebApplication1 
位 置 () 
WebApplication1 


图 14-1 选择 项 目 类 型 


步骤 3: 输入 项 目 /解决 方案 的 名 字 , 单 击 “ 确 定 ” 按 钮 。 
步骤 4: 然后 会 打开 一 个 选项 窗口 ,在 窗口 中 选择 “ 空 "( 即 空白 的 Web 应 用 程序 ) ,同时 
不 勾 选 窗口 下 方 的 “为 HTTPS 配置 ?选项 (暂时 不 需要 HTTPS 配置 ) ,如 图 14-2 所 示 。 


“|AsPNET Core 2.1 。、 了 站 更 全 
a 用 于 创建 ASP.NET Core 应 用 程序 的 空 项 目 模板 。 此 模 
a 
图 国 中 板 中 没有 任何 庆 容 .。 
Apl 。 ”Web 应 用 程序 Web 应 用 程序 。Razor 类 库 了 训 于 全 
( 恒 型 疯 图 控制 
玖 
四 和 多 
Angular Reactjs Reactjs 和 
Redux 
作者 :Microsoft 
源 : SDK 2.1.402 
口 启用 pocker 支 持 介 身份 验证 ， 不 进行 身 亿 验证 
运作 至 统 ， Windows 的 验 下 | 
要 求 用 于 Windows 的 Docker 
还 可 以 身后 启用 Docker 支持 了 让 更 多 
口 为 HTTPS 出 (O) 
确定 (O) 取消 (O 


图 14-2 选择 Web 应 用 项 目 配置 
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步骤 5: 单 击 “ 确 定 ” 按 钮 ,创建 项 目 。 
步骤 6: 待 应 用 程序 项 目 创建 完成 后 ,找到 Program 类 ,并 定位 到 Main 方法 ,将 模板 默 
认 生 成 的 代码 删除 ,并 输入 以 下 代码 。 


IWebHostBuilder builder = WebHost.CreateDefaultBuilder(args).UseStartup < Startup>(); 

// 创建 Web 宿主 

IWebHost host = builder. Build(); 

// 启动 Web 主机 

host. Run(); 

调用 CreateDefaultBuilder 方法 之 后 ,还 需要 调用 UseStartup 方法 指定 一 个 类 ,这 个 类 
由 项 目 模板 默认 生成 ,并 命名 为 Startup。 初 始 化 Web 主机 时 需要 用 到 这 个 类 , 它 主要 负责 
配置 应 用 程序 要 用 到 的 服务 组 件 以 及 中 间 件 。 

CreateDefaultBuilder 方法 还 有 一 个 重 载 ,可 以 直接 指定 Startup 类 ,所 以 上 面 代 码 可 以 


精简 为 以 下 形式 。 
IWebHostBuilder builder = WebHost.CreateDefaultBuilder < Startup>(args); 


调用 Run 方法 后 ,Web 应 用 程序 就 处 于 运行 状态 ,直到 应 用 程序 退出 。 
步骤 7: 运行 应 用 程序 。 当 应 用 程序 启动 后 ,会 启动 默认 浏览 器 ,并 定位 到 指定 的 


URL, 如 图 14-3 所 示 。 


4] © localhost51135/ 区 | a 


这 是 一 个 简单 的 Web 应用! 


图 14-3 在 浏览 器 查看 Web 应 用 的 运行 结果 


实例 327 ”配置 Web 服务 器 的 URL 


【导语 】 

对 Web 服务 器 的 配置 都 在 WebHostBuilder 对 象 上 完成 ,一 旦 调用 Build 方法 生成 服 
务 主机 后 就 不 要 再 更 改 配置 了 ,尤其 是 用 于 监听 客户 端 请 求 的 URL。 指 定 URL 的 方法 有 
很 多 种 ,比较 常用 的 有 以 下 三 种 : 

(1) 调用 UseUrls 方法 。 这 是 一 个 扩展 方法 , 它 的 内 部 调用 了 IWebHostBuilder 的 
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UseSetting 方法 。UseUrls 方法 使 用 可 变 个 数 的 字符 串 对 象 作为 参数 ,可 以 方便 地 指定 多 
URL; 

(2) 调用 UseSetting 方法 ,配置 的 key 参数 为 WebHostDefaults. ServerUrlsKey 字段 
( 即 字符 串 “urls”) ,配置 的 值 是 一 个 单独 的 字符 串 实例 ,如 果 有 多 个 URL, 需 要 用 英文 的 分 
号 分 隔 。 

(3) 通过 配置 文件 ,如 默认 的 appsettings. json, 可 以 自 定义 文件 名 。 

URL 的 格式 一 般 为 “协议 方案 ”十 “主机 名 ”十 “端口 ”, 例 如 以 下 格式 。 

http://localhost:6000 

如 果 需 要 监听 本 机 某 个 端口 上 的 所 有 地 址 ,可 以 用 星 号 (* ) 或 者 加 号 (十 ) 代 替 主 机 名 ， 
格式 如 下 。 

http://* :8005 

本 实例 将 演示 通过 三 种 方法 设置 Web 服务 器 的 URL。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 项 目 。 

步骤 2: 找到 Program 类 的 Main 方法 ,删除 里 面 的 代码 ,替换 为 以 下 代码 。 


var builder = new WebHostBuilder() 
.UseKestrel() 
.UseIISIntegration() 
.UseStartup< Startup>() 
.UseUrls("http://localhost:6500"); 
builder. Build(). Run(); 


也 可 以 指定 多 个 URL。 
var builder = new WebHostBuilder() 
.UseUrls("http://localhost:6500", "http://localhost:7000", "http://* :9730"); 
步骤 3: 使 用 UseSetting 方法 也 可 以 配置 URL。 
var builder = new WebHostBuilder() 
.UseSetting(WebHostDefaults. ServerUrlsKey, "http://localhost:8990"); 
如 果 要 配置 多 个 URL ,请 用 英文 的 分 号 隔 开 。 
var builder = new WebHostBuilder() 


.UseSetting(WebHostDefaults. ServerUrlsKey, "http://localhost:8990; 
http://localhost:46133"); 
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注意 ; UseSetting 方法 的 value 参数 是 单个 字符 串 实例 ,所 以 多 个 URL 都 是 用 一 个 字符 串 
实例 来 表示 的 ,这 与 UseUrls 方法 不 同 。 


[i 


步骤 4: 还 可 以 用 json 文件 配置 。 在 项 目 目 录 中 新 到 
json ,并 在 新 的 JSON 文件 中 输入 以 下 内 容 。 


站 
"urls" : "http://localhost:3600;http://* :80" 


} 
步骤 5: 然后 回 到 Main 方法 ,对 代码 做 以 下 修改 。 


-个 json 文件 ,假设 命名 为 host. 


var builder = new WebHostBuilder() 
.UseStartup< Startup>(); 


ConfigurationBuilder config = new ConfigurationBuilder(); 
config. SetBasePath(builder. GetSetting(WebHostDefaults. ContentRootKey)) 
.AddJsonFile("host. json"); 

builder. UseConfiguration(config. Build()); 

builder. Build().Run(); 

要 使 配置 生效 ,不 能 调用 ConfigureAppConfiguration 方法 ,因为 此 方法 仅 用 于 配置 应 
用 程序 级 别 的 参数 ,而 不 是 Web 主机 级 别 的 参数 。 此 时 需要 通过 ConfigurationBuilder 对 
象 生 成 一 个 新 的 配置 对 象 , 然 后 调用 UseConfiguration 方法 对 默认 的 配置 进行 覆盖 。 

SetBasePath 方法 的 作用 是 设 定 一 个 基础 的 目录 路 径 , 随 后 在 调用 AddJsonFile 方法 添加 
JSON 文件 时 ,只 需要 提供 文件 名 即 可 , 即 相对 路 径 ( 相 对 于 SetBasePath 方法 所 指定 的 路 径 ) 。 

步骤 6: 运行 应 用 程序 ,效果 如 图 14-4 所 示 。 


14-4 在 自 定义 的 URL 上 监听 HTTP 请 求 


实例 328 ”使 用 Kestrel 服务 器 组 件 


【导语 】 
ASP. NET Core 应 用 程序 是 运行 在 独立 的 Web 服务 器 容器 中 的 ,Web 服务 器 组 件 要 
求 必须 实现 IServer 接口 ,开发 者 可 以 自己 编写 服务 器 组 件 或 者 使 用 其 他 第 三 方 组 件 。 
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ASP. NET Core 框架 默认 实现 的 Web 服务 器 组 件 是 Kestrel。 

WebHost 类 的 CreateDefaultBuilder 方法 内 部 已 默认 使 用 Kestrel 服务 器 组 件 , 但 是 如 
果 开 发 者 自己 编写 代码 来 创建 Web 主机 (而 不 是 直接 调用 CreateDefaultBuilder 方法 ), 则 
必须 显 式 调用 UseKestrel 扩展 方法 以 启用 Kestrel 服务 器 组 件 ,否则 运行 应 用 程序 后 会 报 
出 如 图 14-5 所 示 的 错误 。 


未 经 处 理 的 异 军 


System.InvalidOperationException:"No service for type 
'MicrosoftAspNetCore.Hosting.ServerlServer has been 
registered.” 


图 14-5 未 找到 已 注册 的 Web 服务 器 组 件 
【操作 流程 】 
步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 
步骤 2: 定位 到 项 目 模板 生成 的 Program. Main 方法 ,输入 以 下 代码 。 


var builder = new WebHostBuilder() 
.UseStartup < Startup >() 
.UseContentRoot (Directory. GetCurrentDirectory()) 
.UseKestrel(); 

builder. Build().Run(); 


步骤 3: IIS 集成 功能 是 可 选 的 ,只 有 在 使 用 IIS 作为 反 向 代理 时 才 有 效 ,要 启用 IIS 集 
成 可 以 调用 UseIISIntegration 方法 。 


var builder = new WebHostBuilder() 


.UseKestrel() 
.UselISIntegration( ); 
builder. Build(). Run(); 


实例 329 ”配置 Web 项 目的 调试 方案 


【导语 】 

在 创建 ASP. NET Core Web 项目 后 ,模板 默认 生成 两 个 调试 方案 : 

(1) 以 IIS Express 为 反 向 代理 运行 应 用 程序 。 

(2) 用 项 目 名 称 命名 ,独立 运行 项 目 ( 通 过 dotnet 命令 执行 )。 

开发 人 员 可 以 根据 实际 需要 对 调试 方案 进行 新 增 、 删 除 和 编辑 。 最 简单 的 配置 方法 是 
通过 项 目 属性 窗口 中 的 “调试 "选项 卡 来 操作 。“ 调 试 " 页 面 的 配置 内 容 保存 在 项 目 目 录 下 的 
\Properties\launchSettings. json 文件 中 ,文件 的 大 致 结构 如 下 : 
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"iisSettings": { 
"windowsAuthentication": false, 
"anonymousAuthentication" : true, 
"iisExpress": { 
"applicationUrl" : "http://localhost:53196", 
"sslPort": 0 
}, 
"profiles": { 
"IIS Express": { 
"commandName" : "IISExpress", 
"launchBrowser" : true, 
"environmentVariables": { 
"RSPNETCORE_ENVIRONMENT" : "Development" 
} 
}, 
"< 与 项 目 名 称 相同 >": { 
"commandName" : "Project", 
"launchBrowser" : true, 
"applicationUrl" : "http://localhost:5000", 
"environmentVariables" : { 
"RSPNETCORE_ENVIRONMENT" : "Development" 
} 


} 


其 中 ,profiles 字段 下 所 包含 的 内 容 就 是 调试 方案 列表 。 方 案 名 称 可 以 自 定义 (模板 生成 的 
默认 名 称 有 两 个 ,一 个 是 "IIS Express”, 另 一 个 与 项 目 同 名 )。commandName 字段 用 于 描 
述 应 用 程序 在 调试 时 的 启动 方式 ,此 值 有 四 个 选项 : 


(1) US Express: 以 JIS Express 作为 反 向 代理 进程 。 

(2) IIS; 以 IIS 服务 (完整 版 IS) 作 为 反 向 代理 进程 。 

(3) Project: 使 用 dotnet 命令 直接 运行 应 用 程序 (附加 . dll 文件 ) 。 

(4) Executable: 自 定义 一 个 可 执行 文件 ,这 种 调试 方案 一 般 不 常用 。 

commandName 字段 之 后 的 各 字段 在 每 种 调试 方案 中 并 不 固定 ,例如 如 果 


commandName 指定 为 Executable, 那 么 随后 就 要 设置 executablePath 字段 以 表示 要 启动 
的 可 执行 文件 的 路 径 。 但 IIS Express 调试 方案 中 则 不 需要 executablePath 字段 。 


【操作 流程 】 
步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 
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步骤 2: 项 目 创建 后 ,打开 项 目 


配置 文件 : 
启动 - 
应 用 程序 区 者 : 


工作 目录 : 


[网 启动 浏览 器 
环境 变量 : 


Taeb 服务 器 设置 


步骤 3: 单 击 “删除 ?按钮 ,将 项 目 模板 默认 生成 的 调试 方案 全 部 删除 。 


属性 窗口 ,切换 到 “调试 ”选项 卡 页 ,如 图 14-6 所 示 。 


应 用 URL(P): http://localhost:53196 


ITS Express 位 数 (B) - | 默认 什 


口 自用 ssL(s) 
启用 匿名 身份 验证 中 
口 自用 Tindows 身份 验证 全 


图 14-6 ”调试 方案 配置 页 面 


I18 Express 新 建 … 暗 除 
ITS Express 
5 参 间 
ep 
名 称 值 
aSPNETCORS_ENVIRONENT | Developmert 添加 
移 除 


步骤 4: 单 击 “新 建 ?按钮 ,弹出 “新 建 配置 文件 "对 话 框 , 在 对 话 框 中 输入 一 个 自 定 义 的 


名 称 , 如 图 14-7 所 示 。 


步骤 5: 在 “启动 ”下拉 列表 框 中 选择 “项 目 ", 即 commandName 字段 为 Project 值 ,如 


图 14-8 所 示 。 


启动 : 


配置 文件 名 称 : [RunApH| 


确定 | | 取消 


图 14-7 为 新 的 调试 方案 命名 


应 用 程序 参数 - 


项 目 


IIS Express 


TS 


I 
可 执行 文件 


图 14-8 ”选择 “项 目 ” 


步骤 6: 在 “环境 变量 "中 添加 一 个 新 项 ,名 称 为 ASPNETCORE_Environment”, 值 为 
“Development”, 如 图 14-9 所 示 。 


“ASPNETCORE_” 是 默认 的 环境 变量 前 级 ,其 后 紧 跟 环境 变量 的 名 字 。 例 如 本 例 中 
环境 变量 名 称 为 “Environment”, 它 表示 应 用 程序 运行 的 环境 ,预定 义 的 值 有 三 个 : 


， 


环境 要 里: Ee 什 


图 14-9 添加 环境 变量 


Development、Staging、Production, 也 是 可 以 自 定义 的 。 

步骤 7: 在 “应 用 URL” 中 填写 Web 应 用 启动 时 监听 的 地 址 ,本 实例 中 使 用 的 地 址 为 
http: //localhost: 6000。 

步骤 8:( 可 选 ) 如 果 需 要 应 用 程序 在 启动 调试 时 自动 打开 浏览 器 ,可 以 勾 选 “启动 浏览 
器 ” 复 选 项 。 

步骤 9: 保存 并 关闭 项 目 属性 窗口 ,此 时 在 Visual Studio 的 调试 工具 按钮 的 级 联 菜单 
里 面 就 包含 自 定义 的 调试 方案 了 。 


14.2 Startup 


实例 330 ”基于 方法 约定 的 Startup 类 


【导语 】 

在 默认 的 项 目 模板 中 ,会 创建 一 个 Startup 类 ,并 通过 WebHostBuilder 的 扩展 方 
法 一 一 UseStartup 来 进行 配置 。Startup 并 未 要 求 类 名 必须 为 Startup ,可 以 自 定义 类 名 ,但 
要 求 类 中 必须 包含 约定 方法 (可 以 是 实例 方法 ,也 可 以 是 静态 方法 ) 。 约 定 方法 有 两 个 : 

(1) ConfigureServices 方法 : 这 个 约定 方法 是 可 选 的 , 当 需 要 向 容器 添加 服务 时 才 定 
义 。 该 方法 只 有 一 个 参数 ,类 型 为 IServiceCollection。 在 ConfigureServices 方法 内 部 可 以 
向 IServiceCollection 集合 添加 要 用 到 的 服务 类 型 。 

(2) Configure 方法 : 此 方法 是 必需 的 , 它 支 持 参 数 的 依赖 注 和 人 ,要 求 必 须 包 含 
IApplicationBuilder 类 型 的 参数 。 如 果 有 其 他 参数 存在 ,IApplicationBuilder 类 型 的 参数 要 
放 在 参数 列表 的 第 一 位 ,其余 参数 将 由 依赖 注入 来 赋值 。 

这 两 个 约定 方法 的 格式 如 下 ， 


void ConfigureServices(IServiceCollection services) 

void Configure( IApplicationBuilder app [,，< 接 收 依 赖 注入 的 参数 >]); 

应 用 程序 在 运行 时 会 查找 约定 方法 的 名 字 , 所 以 在 Startup 类 型 中 声明 时 ,方法 名 称 必 
须 正确 ,否则 运行 时 将 因 找 不 到 约定 的 方法 而 发 生 错 误 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 
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步骤 2: 删除 项 目 模板 生成 的 Startup 类 ,随后 重新 定义 一 个 ,并 且 类 名 为 MyStartup。 


public class MyStartup 


{ 
public void ConfigureServices(IServiceCollection services) 
{ 
1 
} 
public void Configure( IApplicationBuilder app) 
{ 
app. Run(async context => 
{ 
// 设置 文本 编码 
context. Response. ContentType = "text/html;charset = UTF — 8"; 
// 返回 消息 给 客户 端 
await context. Response. Writehsync(" 这 是 一 个 Web 应 用 "); 
DD); 
} 
} 
app. Run 方法 定义 如 何 处 理 HTTP 请 求 , 本 例 中 比较 简单 ,直接 向 客户 端 回 写 一 条 文 
本 消息 。 


步骤 3: 找到 Program 类 的 Main 方法 ,删除 项 目 模板 生成 的 代码 ,替换 为 以 下 代码 。 


public static void Main(string[] args) 


{ 
var builder = new WebHostBuilder() 
.UseContentRoot (Directory. GetCurrentDirectory()) 
.UseKestrel() 
.UseStartup < MyStartup>(); 
builder. Build(). Run(); 
} 


UseStartup 扩展 方法 指定 定义 好 的 类 一 一 MyStartup。 


实例 331 使 用 IStartup 接口 定义 Startup 类 

【导语 】 

不 仅 可 以 使 用 约定 方法 来 定义 Startup 类 ,还 可 以 通过 实现 IStartup 接口 来 定义 
Startup 类 。 此 接口 的 成 员 列 表 如 下 : 


public interface IStartup 


{ 
void Configure(IRpplicationBuilder app) 
IServiceProvider ConfigureServices(IServiceCollection services); 
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从 接口 的 成 员 列表 中 可 以 发 现 ,实现 该 接口 的 类 型 也 需要 公开 名 为 ConfigureServices 与 
Configure 的 方法 。 

同时 ,框架 提供 了 一 个 抽象 类 一 一 StartupBase, 这 个 类 已 经 实现 IStartup 接口 ,因此 既 
可 以 直接 实现 IStartup 接口 ,也 可 以 实现 StartupBase 抽象 类 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 删除 项 目 模板 默认 生成 的 Startup 类 。 

步骤 3: 重新 定义 Startup 类 ,并 实现 IStartup 接口 。 


public class Startup : IStartup 
{ 
public void Configure( IApplicationBuilder app) 
{ 
app, Run(async (context) => 
{ 
context. Response. ContentType = "text/html;charset = UTF — 8"; 
await context. Response. WriteAsync( "我 的 Web 应 用 程序 "); 
D); 
} 


public IServiceProvider ConfigureServices(IServiceCollection services) 
{ 
return services. BuildServiceProvider(); 
} 
} 


由 于 这 种 Startup 类 的 实现 并 非 约定 ,不 能 在 Configure 方法 上 接收 依赖 注入 的 对 象 ， 
但 可 以 通过 构造 函数 参数 来 注入 。 


public class Startup : IStartup 

{ 
IHostingEnvironment _hostEnv; 
public Startup(IHostingEnvironment env) 
{ 


_hostEnv = env; 
} 
} 
然后 可 以 在 Configure 方法 中 访问 。 


public void Configure( IApplicationBuilder app) 
{ 
app. Run(async (context) => 


{ 
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context. Response. ContentType = "text/htnl;charset = UTF— 8"; 
await context. Response. WriteAsync( $ "我 的 Web 应 用 程序 , 它 运 行 在 
{_hostEnv. EnvironmentName} 环境 中 "); 


步骤 4: 运行 应 用 程序 ,在 浏览 器 中 将 看 到 如 图 14-10 所 示 的 内 容 。 


回 localhost x 


ey © localhos 六 [5 | 到 


我 的 Web 应 用 程序 ， 它 运行 在 
Development 环境 中 


图 14-10 浏览 器 输出 内 容 


实例 332 无 Startup 启动 应 用 程序 


【导语 】 
定义 Startup 类 (类 名 可 以 不 为 Startup) 只 是 为 了 配置 应 用 程序 时 方便 ,实际 启动 应 用 
程序 时 可 以 不 使 用 Startup 类 。 
IWebHostBuilder 接口 (默认 实现 类 是 WebHostBuilder) 公 开 了 ConfigureServices 方 
法 ,可 以 使 用 该 方法 来 添加 应 用 程序 需要 的 服务 。 此 外 ,可 以 调用 IWebHostBuilder 的 
Configure 扩展 方法 配置 应 用 程序 以 及 HTTP 通信 信道。 具备 了 ConfigureServices 方法 和 
Configure 方法 后 ,在 不 指定 Startup 类 型 的 情况 下 也 能 正常 运行 应 用 程序 。 
【操作 流程 】 
步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 
步骤 2: 删除 项 目 模板 生成 的 Startup 类 。 
步骤 3: 定位 到 Program 类 下 面 的 Main 方法 ,删除 默认 生成 的 代码 。 
步骤 4: 在 Main 方法 内 部 输入 以 下 代码 。 
IWebHostBuilder builder = new WebHostBuilder() 
.UseKestrel() 
.UseIISIntegration() 
.UseContentRoot (Directory. GetCurrentDirectory( )) 
.UseUrls("http://localhost:8605") 


.ConfigureServices(services => 


{ 


// 按 需 添加 服务 
}) 
.Configure(app => 
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app, Run(async context => 
{ 
context. Response. ContentType = "text/plain;charset = UTF — 8"; 
await context. Response. WriteAsync(" 你 好 ,Web 应 用 程序 !"); 
DD); 
D); 
builder. Build().Run(); 


x 


Configure 方法 接受 一 个 带 lApplicationBuilder | 日 ocan x | oe = 
类 型 参数 的 委托 ,处 理 方法 与 Startup. Configure 方 es @ localhostB605/ 六 
法 一 样 。 本 实例 直接 调用 Run 方法 向 客户 端 回 写 一 
条 文本 消息 。 你 好 ，Web 应 用 程序 ! 

步骤 5: 运行 应 用 程序 。 

步骤 6: 在 浏览 器 地 址 栏 中 输入 http://localhost: 
8605, 然 后 按 下 Enter 键 ,会 看 到 如 图 14-11 所 示 的 
输出 。 图 14-11 无 Startup 类 型 启 动 Web 应 用 


14.3 启动 环境 


实例 333 ”使 用 非 预 定义 环境 

【导语 】 

框架 预定 义 的 启动 环境 有 三 个 : 

(1) Development: 在 开发 阶段 使 用 。 例 如 在 此 启动 环境 中 ,应 用 程序 会 显示 详细 的 异 
常 信息 ,以 帮助 调试 。 

(2) Staging: 应 用 程序 正式 上 线 之 前 使 用 ,类 似 于 预览 版 本 。 

(3) Production: 应 用 程序 已 正式 上 线 并 投入 生产 时 使 用 。 例 如 此 环境 中 应 该 禁止 显 
示 异 常 详细 页 ,禁用 一 些 不 必要 的 日 志 以 提高 性 能 等 。 

预定 义 的 启动 环境 仅仅 是 个 参考 ,开发 人 员 可 以 根据 实际 的 开发 场景 自 定义 启动 环境 
的 名 称 。 在 应 用 程序 的 任意 代码 中 ,随时 可 以 通过 访问 IHostingEnvironment. 
EnvironmentName 属性 来 检测 应 用 程序 当前 所 使 用 的 环境 ,也 可 以 调用 IsEnvironment 扩 
展 方法 来 进行 判断 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 定位 到 Program 类 下 的 Main 方法 ,删除 项 目 模板 生成 的 代码 ,并 输入 以 下 
代码 。 


var builder = new WebHostBuilder() 
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.UseEnvironment ("Preview") 
.UseKestrel() 
.UseUrls("http://localhost:6000") 
.UseContentRoot (Directory. GetCurrentDirectory( )) 
.UseStartup< Startup >(); 

var host = builder.Build(); 

host. Run( ); 


UseEnvironment 扩展 方法 用 于 设置 应 用 程序 的 启动 环境 ,此 处 使 用 了 自 定义 名 称 
“Preview” 。 

步骤 3; Startup 类 的 Configure 方法 支持 依赖 注入 ,因此 可 以 声明 IHostingEnvironment 
类 型 的 参数 以 接收 注入 ,随后 可 以 根据 应 用 程序 运行 环境 的 不 同 , 向 客户 端 返回 不 同 的 消息 。 


public void Configure( IApplicationBuilder app, IHostingEnvironment env) 
{ 
app. Run(async (context) => 
{ 
context. Response. ContentType = "text/htnl;charset = UTF— 8"; 
string responseMessage = null; 


if(env.IsEnvironment ("Preview")) 


{ 
responseMessage = "应 用 目前 仍 处 于 预览 阶段 "; 
} 
else 
此 
responseMessage = "应 用 已 正式 上 线 "; bah | 可 让 a 
} 
await context. Response. WriteAsync 0 © localhost6000/ 六 
(responseMessage); 
DD); 应 用 目前 仍 处 于 预览 阶段 
} 
步骤 4: 运行 应 用 程序 ,并 从 浏览 器 中 访问 对 
应 的 URL。 由 于 设置 的 启动 环境 为 Preview, 因 此 


浏览 器 中 显示 “应 用 目前 仍 处 于 预览 阶段 ”, 如 图 14-12 应 用 程序 运行 在 自 定义 环境 中 
图 14-12 所 示 。 


实例 334 使 Startup 类 匹配 启动 环境 


【导语 】 

Startup 类 可 以 根据 不 同 的 环境 来 进行 匹配 ,匹配 方案 有 两 种 : 

(1) 类 型 匹配 , 即 通过 Startup 类 的 命名 来 与 环境 匹配 。 例 如 ,用 于 开发 环境 的 Startup 
类 可 以 命名 为 StartupDevelopment, 用 于 生产 环境 则 可 以 命名 为 StartupProduction。 命 名 
格式 为 : < 类 名 >{EnvironmentName)。 
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(2) Startup 类 不 与 环境 匹配 ,而 是 使 约定 方法 与 环境 匹配 。Configure 方法 的 命名 格 
式 为 : Configure{ EnvironmentName}) ,例如 ConfigureDevelopment; ConfigureServices 方 
法 的 命名 格式 为 : Configure{ EnvironmentName}) Services, 例 如 ConfigureProductionServices。 

开发 者 不 仅 需 要 编写 特定 于 环境 的 Startup 类 ,还 应 该 编写 默认 的 Startup 类 ,这 样 如 
果 程 序 找 不 到 与 环境 匹配 的 Startup 类 ,还 可 以 使 用 默认 的 Startup 类 ( 即 不 带 有 
{EnvironmentName} 标 识 的 命名 )。 

本 实例 将 演示 为 Development 环境 编写 特定 的 Configure 方法 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Startup 类 中 ,定义 ConfigureDevelopment 方法 。 


public void ConfigureDevelopment( IApplicationBuilder app) 
{ 
app. Run(async context => 
{ 
context. Response. ContentType = "text/htnl;charset = UTF— 8"; 
await context. Response. WriteAsync(" 在 开发 环境 中 运行 "); 
}) 7 
} 


步骤 3: 运行 应 用 程序 ,由 于 在 默认 情况 下 项 目 模板 会 配置 为 Development 环境 ,因此 
会 调用 ConfigureDevelopment 方法 。 


依赖 注入 与 中 间 件 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。 服务 ; 

。 依赖 注入 ; 

， 中 间 件 。 


15.1 服务 


实例 335 ” 枚 举 应 用 程序 中 已 添加 的 服务 


【导语 】 

ASP. NET Core 项 目 中 的 “服务 ”, 指 的 是 用 于 扩展 应 用 程序 功能 的 一 系列 类 型 。 在 应 
用 程序 初始 化 期 间 ,会 把 需要 的 服务 类 型 实例 添加 到 ServiceCollection 集合 中 ,这 些 添加 到 
集合 中 的 服务 实例 将 通过 依赖 注入 提供 给 其 他 代码 使 用 (例如 可 以 注入 控制 器 的 构造 函 


数 中 )。 
本 实例 将 枚 举 在 应 用 程序 启动 期 间 添 加 到 ServiceCollection 中 的 服务 实例 。 
【操作 流程 】 


步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 
步骤 2: 在 Main 方法 中 输入 以 下 代码 ,初始 化 Web 服务 器 。 


var host = new WebHostBuilder() 
.UseContentRoot(Directory. GetCurrentDirectory( )) 
.UseKestrel() 
.UseStartup< Startup >() 
.Build(); 

host. Run( ); 


步骤 3: 定位 到 Startup 类 的 ConfigureServices 方法 ,在 此 方法 中 对 services 参数 中 的 
元 素 进 行 枚 举 。 


public void ConfigureServices( IServiceCollection services) 
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{ 
foreach (var sv in services) 
{ 
string msg = $ "服务 类 型 :{sv. ServiceType?. Name ?? "< 无 >"}"; 
msg += $", 实 现 类 型 :{sv. ImplementationType?. Name ?? "< 无 >"}"; 
Console. WriteLine(msg); 
} 
} 


步骤 4: 运行 应 用 程序 ,输出 的 服务 列表 如 图 15-1 所 示 。 


onLifetime 


15-1 枚 举 应 用 程序 的 服务 列表 


实例 336 ”编写 服务 类 型 


【导语 】 

编写 服务 类 型 有 三 种 方案 : 先 定义 一 个 接口 ,然后 定义 一 个 类 去 实现 这 个 接口 ,再 将 
这 个 服务 接口 以 及 接口 的 实现 类 一 起 添加 到 IServiceCollection 集合 中 ; @ 先 定义 抽象 类 ， 
然后 定义 一 个 实现 该 抽象 类 的 新 类 ,再 将 这 个 抽象 类 与 它 的 实现 类 一 起 添加 到 
IServiceCollection 集合 中 ; @ 不 定义 接口 类 型 ,而 是 直接 定义 一 个 类 来 实现 服务 功能 ,然后 
把 这 个 类 添加 到 IServiceCollection 集合 中 。 

本 实例 将 分 别 演示 这 三 种 服务 的 实现 方案 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 
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步骤 2: 第 一 个 服务 类 型 使 用 接口 与 实现 类 的 方式 定义 。 


public interface IServicel 
{ 
void OnAction(HttpContext _context); 


internal class MyServicel : IServicel 
和 
public void OnAction(HttpContext _context) 


{ 
_context. Response. Headers. Add( "addon", "Service 01"); 


} 
步骤 3: 第 二 个 服务 类 型 使 用 抽象 与 实现 类 的 方式 实现 。 


public abstract class ServiceBase 
{ 
public abstract void OnBacked(HttpContext _context); 


internal class MyService2 : ServiceBase 
{ 
public override void OnBacked(HttpContext _context) 
_context. Response. Headers. Add( "returnBack", "Service 02"); 


} 
步骤 4: 第 三 个 服务 类 型 直接 定义 一 个 类 来 实现 。 


public class MyService3 
{ 
public void Checks(HttpContext _context) 


{ 
_context. Response. Headers. Add( "checked", "Service 03"); 


} 
步骤 5: 定位 到 Startup 类 的 ConfigureServices, 依 次 将 上 述 三 种 服务 类 型 向 服务 容器 注册 。 


public void ConfigureServices( IServiceCollection services) 
{ 
services. AddSingleton < IServicel, MyServicel >(); 
services. AddSingleton < ServiceBase, MyService2 >(); 
services. AddSingleton < MyService3 >(); 
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步骤 6: 在 Configure 方 法 的 参数 列表 中 加 上 以 上 三 个 服务 类 型 的 声明 ,以 实现 依赖 
注 秦 > 

public void Gonfigure( IApplicationBuilder app, TServitel svl, Servicedase sv2, MySerrices sv3) 

{ 


} 


第 一 个 服务 使 用 其 定义 的 接口 IServicel 来 声明 参数 ,第 二 个 服务 使 用 抽象 类 
SerivceBase 来 声明 参数 ,最 后 一 个 服务 只 单独 由 一 个 类 实现 ,所 以 直接 用 MyService3 类 来 
声明 参数 。 

步骤 7: 在 app. Run 方法 的 委托 内 部 ,依次 调用 三 个 服务 。 


app. Run(async (context) => 
{ 

sv1. OnAction(context); 

sv2.OnBacked( context); 

sv3.Checks(context); 

g ; " my 。 

await context. Response. WriteAsync("Hello World! "); a 

Ds; checked: Service 03 


步骤 8: 运行 应 用 程序 ,结果 如 图 15-2 所 示 。 人 


三 个 服务 的 功能 都 是 使 用 HttpContext 对 象 添加 响应 消 。 sever Kesel 
息 的 HTTP 标 头 ,因此 当 实 例 应 用 运行 后 ,可 以 通过 浏览 器 的 


“开发 人 员工 具 "来 查看 被 添加 的 HTTP 标 头 。 0 
实例 337 ”理解 服务 的 生命 周期 
【导语 】 


服务 类 型 添加 到 ServiceCollection 容器 后 ,其 生命 周期 将 由 框架 自动 管理 。 容 器 中 的 
服务 存在 三 种 生命 周期 : 

(1) 暂时 服务 : 通过 调用 AddTransient 方法 添加 。 暂 时 服务 的 生命 周期 是 最 短 的 , 它 
会 在 每 次 被 请 求 使 用 时 都 实例 化 一 次 ,属于 轻 量 级 服务 。 就 算是 在 同一 个 请 求 中 多 次 访问 ， 
暂时 服务 每 次 都 会 进行 实例 化 。 

(2) 作用 域 服务 : 这 个 “作用 域 ”的 范围 是 单个 请 求 ,通过 AddScoped 方法 添加 。 也 就 
是 说 在 单个 请 求 中 (从 客户 端 向 服务 器 发 出 请 求 到 服务 器 回 发 响应 消息 的 整个 过 程 ) ,不 管 
被 请 求 访问 多 少 次 ,作用 域 服务 都 只 进行 一 次 实例 化 。 

(3) 单 实例 服务 : 通过 AddSingleton 方法 添加 。 此 种 服务 在 整个 应 用 程序 运行 期 间 只 
创建 一 个 实例 ,不 管 有 多 少 次 请 求 , 也 不 管 被 请 求 访问 多 少 次 ,此 服务 只 实例 化 一 次 。 

本 实例 将 定义 四 个 服务 类 ,其 中 ,ServiceA 表示 暂时 服务 ,ServiceB 表示 作用 域 服务 ， 
ServiceC 表示 单一 实例 服务 ,以 及 ServiceDependencyAll 服务 ,这 个 服务 比较 特殊 , 它 的 构 
造 函 数 会 接收 来 自前 面 三 个 服务 的 依赖 注入 。 同 时 ,这 四 个 服务 都 会 注入 Demo 控制 器 的 
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构造 函数 中 , 即 在 一 个 Web 请 求 期 间 ,ServiceA、ServiceB 和 ServiceC 这 三 个 服务 被 访问 过 
两 次 。 第 一 次 被 访问 是 注入 Demo 控制 器 中 ,第 二 次 被 访问 是 注入 ServiceDependencyAll 
服务 中 ,并 且 三 个 服务 类 在 实例 化 的 时 候 都 会 产生 一 个 新 的 GUID。 通 过 本 实例 ,可 以 直观 
地 看 到 容器 中 的 服务 在 各 种 生命 周期 下 的 状态 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 先 声明 一 个 ServiceBase 类 ,作为 后 面 三 个 服务 的 共同 基 类 ,ServiceBase 类 的 
主要 功能 是 产生 新 的 GUID。 


public class ServiceBase 


public Guid ID { get; } 


protected ServiceBase( ) 
{ 
ID = Guid. NewGuid(); 


} 
} 


步骤 3: 从 ServiceBase 派生 出 三 个 类 ,这 三 个 类 就 是 本 实例 要 用 到 的 三 个 服务 。 


public sealed class ServiceA : ServiceBase { } 
public sealed class ServiceB : ServiceBase { } 
public sealed class ServiceC : ServiceBase { } 


步骤 4: 青 定义 第 四 个 服务 类 ,该 类 的 功能 是 在 构造 函数 中 接收 来 自前 三 个 服务 的 
注入 。 


public class ServiceDependencyAll 
{ 


public ServiceDependencyAll(ServiceA sva, ServiceB svb, ServiceC svc) 
{ 

Service A = sva; 

Service B = svb; 

Service C = sve; 


} 


public ServiceBase Service A { get; } 

public ServiceBase Service B { get; } 

public ServiceBase Service C { get; } 
} 


请 求 依赖 注入 的 方法 很 简单 ,在 公共 构造 函数 中 声明 所 需要 服务 类 型 的 参数 即 可 , 当 杠 
架 调 用 构造 函数 时 ,会 自动 给 参数 赋值 。 
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步骤 5: 定义 Demo 控制 器 ,在 其 构造 函数 中 ,接收 来 自 上 述 四 个 服务 的 注入 。 


public class DemoController : Controller 


{ 


private readonly ServiceA _serviceA = null; 


private readonly ServiceB _serviceB = null; 


private readonly ServiceC serviceC = null; 


private readonly ServiceDependencyAll _serviceDep = null; 


public DemoController(ServiceA a, ServiceB b, ServiceC c,ServiceDependencyAll d) 


{ 


Herviceh = as 


_serviceB = b; 


_ServiceC = c; 


_ServiceDep = d; 


步骤 6: 在 Demo 控制 器 内 定义 Check 方法 ,作为 MVC 中 的 Action。 


public class DemoController : Controller 


{ 


public IActionResult Check() 


{ 


List < string> strLines = new List< string>(); 


strLines. 
strLines 
strLines. 
strbines. 
strLines. 
strLines. 
strLines 
strLines 


add( $ "暂时 服务 :{_serviceA.ID}"); 


. Add( $ "作用 域 服 务 :{_serviceB. ID}"); 


Add( $ "单一 实例 服务 :{_serviceC. ID}"); 

Add( string. Empty); 

Add( "存在 依赖 关系 的 服务 :"); 

Add( $ "暂时 服务 :{_serviceDep. Service A. ID}"); 


. Add( $" 作 用 域 服务 :{_serviceDep. Service_B.ID}"); 
.Add( $ "单一 实例 服务 : {_serviceDep. Service_C. ID}"); 


return View(" 一 /DemoView. cshtml", strLines); 


} 


步骤 7: 找到 Startup 类 的 ConfigureServices 方法 ,把 前 面 定义 的 四 个 服务 都 添加 到 服 


务 容器 中 。 


public void ConfigureServices( lServiceCollection services) 


{ 


services. AddMvc( ); 
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services. AddTransient < ServiceA >(); 
services. AddScoped < ServiceB >(); 
services. AddSingleton < ServiceC >(); 


services. AddTransient < ServiceDependencyAl1 >(); 


} 

步骤 8: 运行 应 用 程序 ,在 浏览 器 中 打开 http: //< 实 际 URL >/Demo/Check ,就 可 以 从 
Web 页 面 上 看 到 各 种 服务 在 实例 化 时 产生 的 GUID 了 。 

步骤 9: 进行 三 次 请 求 测试 ,认真 观察 生成 的 GUID 以 寻找 规律 ,参照 表 15-1。 


表 15-1 三 次 请 求 产生 的 GUID 
第 一 次 请 求 a 
€¢< DO 全 © localhost54450/ds 去 [53 | 0 


暂时 服务 : 5caaebb9-2f47-485a-9d77-d763c11bic98 
作用 域 服务 : b8dec236-d8ff-4044-a002-a5276b2db0de 
单一 实例 服务 : a26ec491-c396-4b9c-8547-f56blf857cc6 


存在 依赖 关系 的 服务 : 

暂时 服务 : 9b20fdfc-52f6-4f5a-bc86-ee2072eab320 
作用 域 服务 : b8dec236-d8ff-4044-a002-a5276b2dbOde 
单一 实例 服务 : a26ec491-c396-4b9c-8547-f56bl1f857cc6 


第 二 次 请 求 | ramost 
< DO 全 © localhost54450/de! 页 [3 | 


暂时 服务 : 1acff097-9fcf-4890-8165-52d2b5e97eaa 
作用 域 服务 : 325b2be3-9cc2-4e60-bd9d-0b6d682c302b 
单一 实例 服务 : a26ec491-c396-4b9c-8547-f56blf857cc6 


存在 依赖 关系 的 服务 : 

暂时 服务 : fbfec480-199c-4eb7-95ab-4195f098b58a 
作用 域 服务 : 325b2bc3-9cec2-4e60-bd9d-0b6d682c302b 
单一 实例 服务 : a26ec491-c396-4b9c-8547-f56blf857cc6 


第 三 次 请 来 | EC | 


< >》 口 会 © localhost54450/de| 雄 史 | 


暂时 服务 : 0a26c4d0-2e92-4bf5-a0c1-18cc898491ea 
作用 域 服务 : bdf04f4a-1421-4513-bbe9-e84352d013a0 
单一 实例 服务 : a26ec491-c396-4b9c-8547-f56blf857cc6 


存在 依赖 关系 的 服务 : 

暂时 服务 : 5bd7eb89-d47b-458d-8d9b-31e2412e3287 
作用 域 服务 : bdf04f4a-1421-4513-bbe9-e84352d013a0 
单一 实例 服务 : a26ec491-c396-4b9c-8547-f56blf857cc6 


从 测试 结果 可 以 发 现 : 在 同一 次 请 求 中 ,作用 域 服务 被 访问 了 两 次 ,但 GUID 是 相同 
的 ,说 明 它 在 同一 个 请 求 范 围 内 只 创建 了 一 个 实例 ; 而 暂时 服务 ,不 管 在 什么 范围 内 ,每 次 
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访问 它 所 产生 的 GUID 都 不 同 , 说 明 每 次 使 用 时 都 会 创建 新 实例 ; 单一 实例 服务 的 GUID 
始终 不 变 , 说 明 在 整个 应 用 程序 中 它 只 创建 了 一 个 实例 。 


15.2 依赖 注入 


实例 338 ”实现 SHA1 计算 服务 


【导语 】 

本 实例 将 编写 一 个 服务 类 ,用 于 计算 输入 文本 的 SHA1 哈 希 码 并 以 Base64 字符 串 的 
形式 返回 。 然 后 将 该 服务 类 注册 到 服务 容器 中 ,并 通过 构造 函数 注入 一 个 Razor Page 页 面 
模型 中 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 程序 项 目 。 

步骤 2: 定义 一 个 SHA1Computer 类 ,作为 计算 哈 希 码 的 服务 。 


public class SHAlComputer 
{ 
public string Compute( string input) 
{ 
byte[ ] data = Encoding. UTF8.GetBytes(input); 
byte[ ] res = nul1; 
using(SHAl sh = SHA1. Create()) 
{ 
res = sh.ComputeHash(data); 
} 


return Convert. ToBase64String(res); 
} 
步骤 3: 在 Startup 类 的 ConfigureServices 方法 中 注册 服务 类 。 


public void ConfigureServices( IServiceCollection services) 
| 

services. AddMvc( ); 

services. AddScoped < SHA1Computer >( ); 
} 


由 于 本 实例 将 用 到 与 Razor Page 相关 的 功能 ,所 以 需要 调用 AddMvc 方法 添加 MVC 
框架 支持 。 
步骤 4: 在 Configure 方 法 中 使 用 MVC 功能 。 


public void Configure( IApplicationBuilder app) 
{ 

app. UseMvc(); 
} 
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上 述 代码 中 调用 AddMvc 方法 只 是 注册 MVC 相关 的 类 型 到 服务 容器 ,而 在 Configure 


方法 中 调用 UseMvc 方法 则 是 将 MVC 相关 的 中 间 件 添加 到 HTTP 通信 通道 中 。 


步骤 5: 定义 一 个 类 ,并 使 它 派生 自 PageModel 类 。 


public class TestModel : PageModel 
t 


} 


类 型 从 PageModel 类 派生 ,表明 它 是 一 个 Razor 页 面 模型 ,可 以 与 Razor 视图 文件 


步骤 6: 在 TestModel 页 面 模型 类 中 声明 SHA1Computer 服务 类 的 私有 字段 ,并 通过 


构造 函数 的 依赖 注入 来 获取 实例 引用 。 


readonly SHAlComputer _hash = null; 
public TestModel(SHAlComputer hs) 
{ 
_hash = hs; 
} 


步骤 7: 定义 OnGet 方 法 ,返回 页 面 视图 。OnGet 是 一 个 约定 方法 ,以 HTTP-GET 方 


式 访问 时 调用 。 


public PageResult OnGet() 
{ 

return Page(); 
} 


Page 方法 返回 与 当前 页 面 模型 关联 的 页 面 视图 。 


步骤 8: 声明 两 个 属性 : InputText 属性 是 从 客户 端 输入 的 即将 要 


本 ; HashedText 属性 则 是 哈 希 计算 结果 的 Base64 字符 串 。 


public string HashedText { get; private set; } 
[Bindproperty] 
public string InputText { get; set; } 


其 中 ,InputText 属性 上 应 用 了 BindProperty 特性 ,作用 是 在 消息 往返 的 过 程 中 保留 该 


属性 的 值 。 如 果 不 添加 这 个 特性 , 当 服 务 器 将 视图 回 发 给 浏览 器 后 ,该 


步骤 9: 定义 OnPostUpload 方法 ,在 方法 中 调用 SHA1Computer 服务 ,计算 在 视图 页 


面 中 输入 文本 的 哈 希 码 。 


public PageResult OnPostUpload() 

{ 
if (string. IsNullOrEmpty( InputText)) 
{ 


return Page( ); 


届 性 的 值 会 丢失 。 


进行 哈 希 计算 的 文 


HashedText = _hash. Compute( InputText) ; 
return Fagel( ) 
} 
步骤 10: 在 项 目 中 新 建 一 个 文件 夹 , 命 名 为 Pages, 这 是 Razor Page 中 页 面 视图 的 默认 
查找 路 径 。 
步骤 11: 在 Pages 目录 下 新 建 一 个 Razor 视图 文件 (文件 后 缀 为 . cshtml) ,在 文件 的 头 
部 添加 以 下 标记 。 
@page 
@nanespace Demo 
@model TestModel 
@addTagHelper * ,Microsoft.AspNetCore.Mvc. TagHelpers 
“@” 符 号 是 Razor 语法 的 标志 ,在 Razor Page 视图 文件 的 第 一 行 必须 写 上 page 指令 
(主要 为 了 区 分 MVC 中 的 视图 )。 第 二 行 定 义 此 Razor 视图 的 命名 空间 ,本 例 中 它 与 项 目 
的 默认 命名 空间 相同 ( 即 Demo) 。 第 三 行 的 model 指令 很 重要 , 它 指定 与 该 视图 关联 的 页 
面 模型 类 ,此 处 要 指定 前 面 定 义 的 TestModel 类 。 第 四 行使 用 addTagHelper 指令 导入 所 
有 HTML 标记 扩展 帮助 器 ,其 中 * ( 星 号 ) 表 示 导 人 程序 集中 的 所 有 标记 帮助 器 类 型 ,后面 
的 是 程序 集 的 名 称 。 
步骤 12: 编写 HTML 文档 。 
< htm] > 
< body> 
< form method = "post"> 
请 输入 文本 :< br/> 


< input type= "text" asp - for = "@Model. InputText" /> 
< input type= "submit" value= "提交 " asp- page- handler = "Upload" /> 


</form> 
<div> 
@{ 
证 (!string. IsNullOrWhiteSpace(Model. HashedText)) 
{ 
<p> 
<fieldset> 
< legend > 处 理 结 果 </legend > 
<span> 
@Model. HashedText 
</span> 
</fieldset > 
</p> 
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form 元 素 中 使 用 了 HTML 帮助 器 中 的 asp- 
page-handler, 用 来 指定 Page Model 类 中 使 用 哪个 方 
法 处 理 此 form 元 素 的 提交 操作 。 此 处 设置 的 


人口 | locahotrooeshon| 区 | …- 


请 输入 文本 : 
[你 子 ， 欢 旬 来 到 这 里 ”| [提交 


handler 名 称 为 Upload, 即 TestModel 类 中 的 
OnPostUpload 方法 ,handler 无 须 指定 约定 名 称 ,所 
以 OnPost 可 以 省 略 。 

步骤 13: 运行 应 用 程序 ,在 浏览 器 打开 的 页 面 中 
输入 文本 ,然后 单 击 “ 提 交 ” 按 钮 ,就 能 看 到 计算 后 的 
SHALI 哈 希 值 , 如 图 15-3 所 示 。 


处 理 结果 
2AAL4wjqWeSyGEfBIjkHeWkLriU= 


图 15-3 显示 输入 文本 的 哈 希 值 


实例 339 Startup. Configure 方法 的 依赖 注入 


【导语 】 
约定 方法 的 依赖 注入 , 较 常见 的 有 两 种 用 法 : 
(1) Startup 类 的 Configure 方法 。 


(2) 作为 中 间 件 类 型 的 Invoke 方法 或 者 InvokeAsync 方法 。 
本 实例 演示 的 是 Startup. Configure 方法 的 依赖 注入 。 在 Configure 方法 中 接收 
ILogger 类 型 的 参数 注入 ,然后 调用 ILogger 的 成 员 方法 来 记录 日 志 。 


【操作 流程 】 


步骤 1: 新建 一 个 空白 的 ASP.NET Core Web 应 用 程序 项 目 。 
步骤 2: 在 Startup. Configure 方法 参数 中 定义 ILogger < TCategoryName > 的 参数 ,其 


中 TCategoryName 为 Startup 类 型 。 


public void Configure( IApplicationBuilder app, ILogger < Startup > logger) 


{ 


} 


步骤 3: 在 app. Run 方法 调用 前 后 记录 日 志 信 息 。 


public void Configure( IApplicationBuilder app, ILogger < Startup > logger) 


i 
app.Run(async (context) => 
{ 


logger. LogInformation(">> 即将 调用 Run 方法 "); 


await context. Response. WriteAsync( "Hello World! "); 


logger.LogInformation(">> Run 方法 调用 完成 "); 


D); 
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步骤 4: 运行 应 用 程序 ,结果 如 图 15-4 所 示 。 


15-4 控制 台 记 录 的 日 志 


实例 340 ”临时 访问 服务 
【导语 】 


有 些 服务 类 型 可 能 要 在 应 用 程序 初始 化 的 过 程 中 临时 使 用 ,一 般 是 在 Main 方法 中 , 比 
较 典 型 的 用 途 就 是 数据 库 的 初始 化 。 在 启动 WebHost 之 前 ,程序 代码 可 能 要 检查 数据 库 


是 否 存 在 ,如 果 不 存在 就 创建 新 的 数据 库 , 然 后 写 入 一 些 初始 数据 。 


当 应 用 程序 在 初始 化 过 程 中 需要 临时 访问 服务 类 型 时 ,可 以 调用 CreateScope 扩展 方 
法 (被 扩展 类 型 为 IServiceProvider) 创 建 一 个 基于 临时 作用 域 的 IServiceScope 对 象 ,然后 
再 通过 这 个 临时 的 IServiceScope 对 象 获取 服务 类 型 的 实例 。 由 于 服务 类 型 访问 完成 后 要 


释放 掉 IServiceScope 对 象 ,因此 建议 将 CreateScope 扩展 方法 的 调用 写 在 using 代码 块 中 ， 


以 便 自 动 清 建 。 


本 实例 将 演示 在 应 用 程序 初始 化 过 程 中 ,临时 获取 IHostingEnvironment 服务 实例 , 然 
后 修改 ApplicationName 属性 。 由 于 IHostingEnvironment 服务 在 容器 中 注册 的 是 单个 实 
例 , 所 以 修改 ApplicationName 属性 后 ,在 应 用 程序 的 其 他 地 方 进行 依赖 注入 也 能 获取 


ApplicationName 属性 的 最 新 值 。 
【操作 流程 】 
步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 


步骤 2: 在 Main 方法 中 ,使 用 WebHost. CreateDefaultBuilder 方法 快速 创建 WebHostBuilder， 


然后 创建 WebHost 实例 。 


var builder = WebHost.CreateDefaultBuilder(args) 
var host = builder 

.UseStartup< Startup >() 

.Build(); 


步骤 3: 临时 提取 IHostingEnvironment 实例 ,修改 ApplicationName 


using(IServiceScope scope = host. Services.CreateScope()) 


{ 


属性 。 


THostingEnvironment env = scope, ServiceProvider. GetRequiredService < IHostingEnvironment >(); 
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env. ApplicationName = 史实 例 应 用 程序 了 ， 
} 
步骤 4: 启动 WebHost 实例 。 


host. Run( ); 


步骤 5; 在 Startup. Configure 方 法 中 ,可 以 通过 依赖 注入 从 参数 中 获取 IHostingEnvironment 
实例 ,然后 由 Response 对 象 向 客户 端 回 发 响应 消息 ,响应 消息 中 包含 ApplicationName 属 


性 的 值 。 
public void Configure( IApplicationBuilder app, IHostingEnvironment env) 
{ 
app. Run(async (context) => oah x 
Ty O localhos 门 友 多 
= "text/ 


Context. Response. ContentType 


htm];charset = UTF — 8"; 
await context. Response. Writehsync( $ "正在 


正在 运行 【实例 应 用 程序 】 


运行 {env. ApplicationNane}"); 
]) 


} 
步骤 6: 运行 应 用 程序 ,浏览 器 中 得 到 的 返回 结 图 15-5 输出 ApplicationName 属性 的 值 


果 如 图 15-5 所 示 。 
15.3 中间 件 
实例 341 以 委托 形式 定义 中 间 件 


【导语 】 
应 用 程序 对 HTTP 请 求 的 处 理 过 程 进行 划分 ,每 个 环节 称 为 中 间 件 .将 各 个 中 间 件 串 


联 起 来 ,就 形成 了 HTTP 管道 ,大 致 的 流程 可 参考 图 15-6 。 


吵 闫 "图 * 国 * 
人 各国 4 本 4 本 4 


图 15-6 HTTP 通信 管道 示意 图 
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执行 中 间 件 的 顺序 与 它们 添加 到 HTTP 管道 的 顺序 相同 , 即 先 添加 的 中 间 件 会 先 执 
行 。 在 HTTP 管道 中 添加 中 间 件 有 三 种 方法 : 

(1) 委托 。 中 间 件 专用 的 委托 类 型 为 RequestDelegate, 对 应 的 方法 结构 就 是 带 
HttpContext 类 型 的 输入 参数 ,并 返回 Task 对 象 。 一 般 来 说 ,委托 方式 适用 于 代码 量 较 少 、 
处 理 逻 辑 比 较 简 单 的 中 间 件 。 

(2) 基于 约定 的 中 间 件 类 。 主 要 的 约定 在 于 类 的 方法 ,基于 约定 的 中 间 件 类 必须 包含 
Invoke 或 InvokeAsync 方法 ,输入 参数 为 一 个 HttpContext 对 象 ,并 返回 Task 对 象 。 中 间 
件 类 可 以 通过 构造 函数 的 依赖 注入 来 获取 下 一 个 中 间 件 的 Invoke 或 InvokeAsync 方法 
引 ls 

(3) 实现 IMiddleware 接口 。 该 接口 同样 包含 InvokeAsync 方法 ,需要 HttpContext 
对 象 作为 输入 参数 ,并 返回 Task 类 型 的 对 象 。 用 这 种 方式 定义 的 中 间 件 需要 在 代码 中 显 
式 将 其 添加 到 服务 容器 中 ,因此 此 种 中 间 件 的 生命 周期 可 以 被 改变 (前 面 两 种 方式 所 定义 的 
中 间 件 都 是 单 实例 模式 ,在 应 用 程序 生命 周期 内 仅 创 建 一 次 实例 ,而 实现 了 IMiddleware 接 
口 的 中 间 件 在 添加 到 服务 容器 时 可 以 手动 设置 它 的 生命 周期 ) 。 

在 每 个 中 间 件 的 实现 代码 中 都 会 通过 和 输入 参数 获得 下 一 个 中 间 件 的 引用 ,这 样 开发 人 
员 可 以 灵活 控制 : 是 先 执行 当前 中 间 件 的 代码 ,还 是 先 执行 下 一 个 中 间 件 的 代码 ,或 者 不 执 
行 下 一 个 中 间 件 而 直接 向 客户 端 回 写 响 应 消息 。 

本 实例 将 演示 通过 委托 的 方式 来 定义 中 间 件 。 实 例 创 建 了 三 个 中 间 件 ,并 在 每 个 中 间 
件 的 代码 中 产生 一 个 字符 串 ( 临 时 存储 在 HttpContext 对 象 的 Items 属性 中 ) ,在 最 后 一 个 
中 间 件 中 ,将 三 个 字符 串 拼接 并 发 回 给 客户 端 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Startup. Configure 方法 中 ,调用 Use 扩展 方法 定义 三 个 中 间 件 。 


app. Use(async (context, next) => 

{ 
context. Items["1inel"] = "第 一 环节 ,完成 "; 
await next(); 

D 

.Use(lasync (context, next) = > 

{ 
context. Itens["line2"] = "第 二 环节 ,完成 "; 
await next(); 

D) 

.Uselasync (context, next) => 


t 


context. Itens["line3"] = "第 三 环节 ,完成 "; 

// 拼接 回应 消息 

var parts = (from o in context. Items select o.Value. Tostring()).AsEnumerable(); 
string responseMessage = string.Join("<br/>", parts); 
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// 设置 编码 
context. Response. ContentType = "text/html;charset = UTF— 8"; 
await context. Response. WriteAsync|(responseMessage); 
await Task. CompletedTask; 
Ds; 


第 三 个 中 间 件 的 代码 中 ,可 以 不 调用 next 委托 引用 ,因为 该 中 间 件 已 经 是 HTTP 管道 
中 的 最 后 一 个 环节 了 。 


注意 : Response. Write 方法 一 般 是 在 最 后 一 个 中 间 件 里 面 调 用 , 即 在 所 有 HTTP 通信 环节 
都 处 理 完毕 后 才 调 用 该 方法 。 一 旦 调用 Write 方法 ,就 开始 向 客户 端 回 写 消息 了 ,这 
会 导致 HTTP 消息 中 某 些 内 容 无 法 被 修改 (例如 HTTP 头 ), 进 而 引发 异常 ,所 以 最 
佳 做 法 是 待 所 有 环节 都 处 理 完 成 了 再 将 消息 发 回 客户 端 。 当 然 , 任 何 中 间 件 的 代码 
中 都 可 以 通过 访问 HasStarted 属性 来 确定 HTTP 响应 是 否 已 经 开始 发 回 给 客户 端 ， 
如 果 值 为 true, 就 不 应 该 再 修改 HTTP 头 了 。 


步骤 3: 运行 应 用 程序 ,浏览 器 输出 结果 如 图 15-7 所 示 。 


-NE 


ee @ localhos 门 女 [5 
第 一 环节 ， 完 成 
第 二 环节 ， 完 成 
第 三 环节 ， 完 成 


图 15-7 三 个 中 间 件 的 处 理 结果 


实例 342 ”定义 中 间 件 类 


【导语 】 

本 实例 将 演示 通过 约定 方式 定义 中 间 件 类 。 一 般 来 说 ,中 间 件 类 的 命名 可 以 带 上 
“Middleware” 后 级 ,这 虽然 不 是 语法 要 求 ,但 是 有 规律 的 命名 方式 可 以 方便 其 他 人 识别 该 
类 是 中 间 件 。 
中 间 件 类 的 约定 中 必须 包含 Invoke 或 者 InvokeAsync 方法 ,此 方法 的 声明 如 下 : 


public Task InvokeAsync(HttpContext context); 
public Task Invoke (HttpContext context); 


除了 HttpContext 类 型 的 参数 外 ,还 可 以 在 该 方法 的 后 面 定义 其 他 参数 ,而 且 参 数 支 持 
依赖 注入 。 
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【操作 流程 】 
步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 
步骤 2: 定义 SampleMiddleware 类 , 它 表 示 一 个 中 间 件 。 


public class SampleMiddleware 
i 
// 下 一 个 中 间 件 的 引用 
private readonly RequestDelegate m next; 
public SampleMiddleware( RequestDelegate next) 
{ 
m next = next; 


} 


public async Task InvokeAsync(HttpContext context) 

{ 
await context. Response. WriteAsync( "Hello Web"); 
// 调用 下 一 个 中 间 件 


await m next(context); 


注意 : 基于 约定 的 中 间 件 类 的 构造 函数 可 以 接收 下 一 个 中 间 件 引用 的 依赖 注入 ,但 是 不 应 
该 使 用 该 构造 函数 来 接收 其 他 服务 的 依赖 注入 ,因为 中 间 件 类 的 生命 周期 与 根 容器 
相同 ,在 应 用 程序 运行 期 间 只 创建 一 次 实例 ,如 果 在 构造 函数 中 接收 服务 类 的 依赖 注 
入 ,会 由 于 始终 保持 实例 的 引用 而 强制 服务 类 的 生命 周期 变 为 单个 实例 模式 。 


步骤 3: 在 Startup. Configure 方法 中 ,调用 
UseMiddleware 扩展 方法 将 自 定义 的 中 间 件 类 添加 
i | @ lecalhos 丫 去 区 

到 HTTP 通信 管道 中 。 


HelloWeb 


public void Configure ( IApplicationBuilder app, 
IHostingEnvironment env) 


{ 


app. UseMiddleware < SampleMiddleware >( ); 图 15-8 自 定义 中 间 件 类 的 调用 结果 
} 


步骤 4: 运行 应 用 程序 ,结果 如 图 15-8 所 示 。 
实例 343” 带 参数 的 中 间 件 


【导语 】 
中 间 件 允许 使 用 参数 ,但 并 不 是 调用 参数 ,而 且 仅 能 在 中 间 件 注册 时 使 用 , 即 在 中 间 件 
的 生命 周期 内 ,参数 只 传递 一 次 。 中 间 件 的 参数 是 通过 构造 函数 传递 的 , 即 在 定义 中 间 件 类 


448 二 | .NET Core 实战 一 -手把手 教 你 掌握 380 个 精彩 案例 


的 构造 函数 时 ,第 一 个 参数 是 HTTP 管道 中 下 一 个 中 间 件 的 引用 (RequestDelegate 委托 )， 
从 第 二 个 参数 开始 可 以 定义 中 间 件 的 参数 。 

当 在 Startup. Configure 方法 中 通过 UseMiddleware 方法 注册 中 间 件 时 ,可 以 传递 参 
数 。 如 果 中 间 件 是 基于 约定 所 定义 的 类 ,那么 传递 的 参数 值 尽 量 不 要 使 用 服务 容器 中 非 单 
实例 模式 的 服务 类 型 ,因为 这 种 中 间 件 在 应 用 程序 运行 期 间 只 实例 化 一 次 ,中 间 件 实例 始终 
会 保留 对 参数 的 引用 ,这 会 使 暂时 服务 或 作用 域 服务 的 实例 强制 变 成 单 实例 服务 。 

【操作 流程 】 

步骤 1: 新建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 定义 一 个 中 间 件 类 。 

public class CalcuMiddleware 


{ 
readonly RequestDelegate next; 


readonly int a, _b; 
public CalcuMiddleware(RequestDelegate next, int a, int b) 
{ 
_next = next; 
A 
b= bi; 


} 


public async Task InvokeAsync(HttpContext context) 

{ 
int result = ax b; 
context. Response. ContentTYpe = "text/htnl;charset = UTF— 8"; 
await context. Response. WriteAsync( $ "{_a} x {_b} = {result}"); 


await next(context); 


3 
该 中 间 件 通过 构造 函数 来 接收 两 个 int 类 型 的 


参数 ,并 在 InvokeAsync 方法 中 计算 两 个 参数 的 乘 > — 

积 ,将 结果 回 写 给 客户 端 。 le 
步骤 3: 在 Startup. Configure 方法 中 注册 中 间 | 15x7=105 

件 , 并 传递 参数 值 。 


app. UseMiddleware < CalcuMiddleware >(15, 7); 


步骤 4: 运行 应 用 程序 ,结果 如 图 15-9 所 示 。 图 15-9 输出 两 个 中 间 件 参数 的 乘积 
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实例 344 ”IMiddleware 接口 的 用 途 


【导语 】 
中 间 件 类 一 般 的 实现 方法 是 使 用 约定 形式 (包含 公共 的 Invoke 或 者 InvokeAsync 方 
法 ) ,有 时 也 可 以 考虑 实现 IMiddleware 接口 ,该 接口 的 原型 如 下 : 


public interface IMiddleware 

1 Task InvokeAsync(HttpContext context, RequestDelegate next); 

} 
IMiddleware 接口 也 包含 InvokeAsync 方法 ,但 它 有 两 个 参数 , context 参数 表示 请 求 的 上 
下 文 数据 ,next 表示 下 一 个 中 间 件 的 引用 。 

基于 约定 的 中 间 件 类 在 应 用 程序 运行 期 间 只 创建 单个 实例 ,而 实现 了 IMiddleware 接 
口 的 中 间 件 类 的 生命 周期 就 可 以 灵活 控制 。IMiddleware 接口 方式 实现 的 中 间 件 ,在 
Startup。Configure 方法 中 调用 UseMiddleware 方法 之 前 ,必须 在 Startup. 
ConfigureServices 方法 中 进行 注册 ,服务 的 注册 可 以 选择 三 种 生命 周期 : 暂时 服务 、 作 用 域 
服务 和 单一 实例 服务 ,可 以 通过 不 同 的 服务 注册 方式 来 控制 中 间 件 类 的 生命 周期 ,例如 ,对 
于 不 太 常 用 的 中 间 件 ,可 以 注册 为 暂时 服务 ,减少 内 存 占用 。 

【操作 流程 】 

步骤 1: 新建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 定义 中 间 件 类 TestMiddleware, 并 让 它 实现 IMiddleware 接口 。 


public class TestMiddleware : IMiddleware 
{ 
public TestMiddleware() 
{ 
Console. WriteLine( $ "类 {GetType(). Name} 的 构造 函数 被 调用 "); 
} 
public async Task InvokeAsync(HttpContext context, RequestDelegate next) 
{ 
// 添加 两 个 响应 头 
context. Response. Headers["item 1"] = "hello"; 
context. Response. Headers["item 2"] = "hi"; 
// 写 人 响应 消息 
context. Response. ContentTYpe = "text/htnl;charset = UTF— 8"; 
await context. Response. WriteAsync(" 欢 迎 来 到 主页 "); 


} 
在 TestMiddleware 类 的 构造 函数 中 会 输出 一 行文 本 ,因此 如 果 中 间 件 在 应 用 程序 运行 


期 间 被 多 次 创建 实例 ,那么 每 次 实例 化 的 时 候 都 会 在 控制 台中 输出 一 行文 本 ,通过 查看 控制 
台 的 输出 内 容 就 可 以 验证 中 间 件 是 否 被 多 次 实例 化 。 
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步骤 3: 在 Startup. ConfigureServices 方法 中 ,对 TestMiddleware 中 间 件 进行 注册 。 


public void ConfigureServices(IServiceCollection services) 


{ 


services. AddTransient < TestMiddleware >(); 


} 


注意 : 通过 实现 IMiddleware 接口 来 定义 的 中 间 件 ,必须 先 在 服务 容器 中 注册 才能 
HTTP 管 迁 中 重用 ， 
步骤 4: 在 Startup. Configure 方法 中 ,使 用 自 定义 中 间 件 。 
app. UseMiddleware < TestMiddleware >(); 


步骤 5: 运行 应 用 程序 ,在 浏览 器 打开 URL 后 ,进行 多 次 刷新 。 可 以 发 现 ,每 次 刷新 后 
控制 台中 都 会 输出 一 行文 本 ,表明 TestMiddleware 中 间 件 创建 了 新 实例 ,如 图 15-10 所 示 。 


Demo 二 口 x 


用 
用 
用 
用 
用 
用 
用 
用 
用 
用 
用 
用 
用 
用 
用 


图 15-10 中 间 件 被 多 次 实例 化 


实例 345 让 HTTP 管道 “短路 ” 

【导语 】 

直接 调用 IApplicationBuilder 的 Run 扩展 方法 会 使 整个 HTTP 请 求 管 道 发 生 “ 短 
路 ”一 一 直接 把 响应 消息 发 回 给 客户 端 ,终止 此 次 HTTP 通信 。 例 如 以 下 代码 调用 了 三 次 
Run 方法 : 


忆 | 


app. Run(async context => 
{ 
await context. Response. WriteAsync( "Hello"); 


D; 
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app. Run(async context => 
{ 
await context. Response. WriteAsync ("My"); 
D; 
app. Run(async context => 
{ 
await context. Response. WriteAsync{( "Friends" ); 


D; 


应 用 程序 在 运行 的 时 候 ,只 有 第 一 个 Run 方法 的 调用 会 被 执行 ,后 面 两 次 调用 都 不 会 被 执 
行 。 这 是 因为 遇 到 了 Run 方法 ,意味 着 整个 HTTP 请 求 管道 将 被 终结 ,并 且 将 处 理 结果 直 
接 发 回 给 客户 端 ,不 管 Run 后 面 还 有 没有 新 插入 的 中 间 件 ,都 不 会 被 执行 。 读 者 可 以 参考 
以 下 Run 扩展 方法 的 源 代码 。 


public static void Run(this IApplicationBuilder app, RequestDelegate handler) 
{ 


if (app == null) 
{ 

throw new ArgumentNullException(nameof (app)); 
} 


if (handler == null) 
{ 

throw new ArgumentNullException( nameof (handler) ); 
} 


app.Use( => handler); 

} 

可 以 看 到 ,使 HTTP 管道 短路 ”的 实现 原理 非常 简单 ,就 是 在 管道 中 插入 一 个 中 间 件 
( 即 传递 给 Run 方法 的 委托 实例 ) ,一旦 这 个 中 间 件 执行 之 后 ,就 不 会 去 调用 下 一 个 中 间 件 ， 
从 而 使 HTTP 管道 终结 , 即 Run 方法 中 添加 的 中 间 件 成 为 HTTP 请 求 处 理 流 程 中 的 最 后 
环节 。 

【操作 流程 】 

步骤 1: 新建 一 个 空白 的 ASP.NET Core Web 应 用 程序 项 目 。 

步骤 2: 项目 模 板 在 Startup. Configure 方法 中 已 经 生成 了 一 条 调用 Run 方法 的 代码 
语句 。 为 了 演示 ,可 以 对 其 做 以 下 修改 。 


app. Run(async context => 

{ 
context. Response. ContentType = "text/html;charset = UTF— 8"; 
await context. Response. WriteAsync(" 你 好 ,世界 "); 

D); 
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步骤 3: 以 下 代码 也 能 实现 与 Run 方法 类 似 的 效果 。 


app. Use(async (context, next) => 

{ 
context. Response. ContentType = "text/html;charset =UTF— 8"; 
await context. Response. WriteAsync( "你 好 ,世界 "); 

DD); 


实例 346 ”中 间 件 的 分 支 映射 


【导语 】 

添加 到 HTTP 管道 的 中 间 件 是 默认 响应 根 URL 请 求 的 ,但 在 实际 开发 中 ,有 时候 需要 
在 根 URL 下 面 通过 子路 径 来 区 分 不 同 的 功能 , 即 根据 不 同 的 子 URL 来 调用 不 同 的 中 
间 件 。 

分 支 映射 有 两 种 比较 常见 的 使 用 场景 : 一 种 用 法 是 错误 处 理 ,例如 根 URL 是 http: // 
abc. org ,可 以 将 http: //abc. org/errors 专用 于 错误 处 理 , 调 用 向 客户 端 返 回 错误 信息 的 中 
间 件 ; 另 一 种 用 法 是 Web Socket, 例如 http: //abc. org/ws 分 支 可 专用 于 Web Socket 
通信 。 

本 实例 将 在 根 URL 的 基础 上 划分 三 个 分 支 , 当 访问 /home 路 径 时 返回 文本 “主页 ”, 当 
访问 /about 路 径 时 返回 文本 “关于 本 站 ”, 访 问 /news 路 径 时 就 返回 文本 “新 闻 列 表 ”。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 首先 在 Startup. Configure 方法 中 定义 一 个 HTTP 管道 主 路 上 的 中 间 件 ,作用 
是 将 回 写 文本 的 字符 编码 设置 为 UTF-8。 


app. Use(async (context, next) => 

{ 
context. Response. ContentType = "text/html;charset = UTF— 8"; 
await next(); 

DD); 


注意 : 在 设置 完 字符 编码 后 ,必须 要 调用 next 委托 ,这 样 接 下 来 的 各 个 分 支 中 的 中 间 件 才 
能 被 调用 。 因 为 如 果 不 调 用 next 委托 ,就 会 直接 终结 HTTP 管道 (与 在 主 路 上 调用 
Run 方法 结果 相同 ) 。 


步骤 3: 接 下 来 是 三 个 分 支 , 分 别 调用 Run 方法 向 客户 端 返回 文本 内 容 , HTTP 管道 中 
的 处 理 过 程 结束 。 
app. Map("/home", _app => 


{ 
_app. Run(async context => 
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await context. Response. WriteAsync(" 主 页 "); 
); 
了 
.Map{"/about", app => 
{ 
_app. Run(async context => 


await context. Response. WriteAsync(" 关 于 本 站 "); 
); 
]) 
.Map{"/news", _app => 


_app. Run(async context => 


await context. Response. WriteAsync(" 新 闻 列 表 "); 


); 
D); 


步骤 4: 运行 应 用 程序 ,可 以 分 别 输入 以 下 URL 来 进行 测试 。 


http://localhost:3125/home 
http://localhost:3125/about 
http://localhost:3125/news 
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MVC 与 Web API 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
。 Razor 面向 Web 页 的 应 用 程序 
。，MVC 与 Web API; 

。 访问 静态 文件 。 


16.1 Razor Web 页 面 应 用 


实例 347” 自 定义 Razor 页 的 根 目 录 

【导语 】 

Razor 页 面 应 用 是 MVC 框架 的 一 种 简化 应 用 , 它 与 传统 的 Web 开发 模式 相似 ,以 页 面 
为 单位 来 划分 应 用 功能 。 

Razor 页 面 在 项 目 中 的 默认 存储 路 径 是 /Pages 目录 , 即 所 有 Razor 页 面 必须 放 在 该 目 
录 下 。 而 请 求 的 URL 中 是 不 包含 根 目 录 名 字 的 ,例如 某 个 页 面 文件 的 路 径 为 /Pages/ 
News/List. cshtml, 那 么 请 求 该 页 面 的 URL 应 为 http: //< 域 名 /端口 >/News/List。 如 果 
不 想 将 Razor 页 面 放 到 /Pages 目录 下 ,可 以 通过 RazorPagesOptions 选项 类 的 
RootDirectory 属性 来 配置 自 定义 的 页 面 存 放 路 径 。 配 置 代码 应 写 在 Startup. 
ConfigureServices 方法 中 ,例如 : 


services. AddMvc( ); 
services. PostConfigure < RazorPagesOptions>(option => 
{ 

option. RootDirectory = "/CustPages"; 


D); 


/CustPages 就 是 自 定义 的 用 于 存储 Razor 页 面 的 根 目录 (相对 于 项 目的 根 目录 )。 
也 可 以 使 用 扩展 方法 来 简单 配置 。 


services. RddMvc( ) . WithRazorPagesRoot("/CustPages" ); 
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如 果 和 希望 把 项 目 所 在 的 目录 直接 作为 Razor 页 面 的 根 目录 ,可 以 按 以 下 方式 配置 。 
services. AddMvc ( ) . WithRazorPagesRoot("/"); 


也 可 以 调用 WithRazorPagesAtContentRoot 扩展 方法 直接 配置 。 


services. RddMvc( ) . WithRazorPagesRtContentRoot( ); 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Starutp. ConfigureServices 方法 中 调用 AddMvec 方法 添加 与 MVC 有 关 的 
服务 ,然后 配置 Razor 页 面 的 根 目录 。 


public void ConfigureServices(IServiceCollection services) 


{ 
services. RddMvc( ) . WithRazorPagesRoot("/DemoPages" ); 


} 
步骤 3: 在 Startup. Configure 方法 中 ,调用 UseMvc 方法 。 


public void Configure( IApplicationBuilder app, IHostingEnvironment env) 


{ 
if (env. IsDevelopment()) 


{ 


app. UseDeveloperExceptionPage( ); 
} 


app. UseMvc(); 


注意 : ConfigureServices 方法 中 必须 调用 AddMvc 方法 来 注册 与 MVC 框架 相关 的 服务 组 
件 ,在 Configure 方 法 中 要 调用 UseMvc 方法 ,将 MVC 相关 的 中 间 件 添加 到 HTTP 
管道 中 ,这 样 应 用 程序 才能 通过 MVC 框架 来 处 理 HTTP 请 求 。 


步骤 4: 在 应 用 程序 项 目 中 新 建 一 个 文件 夹 ,命名 为 DemoPages (与 上 文中 
WithRazorPagesRoot 方法 指定 的 目录 匹配 )。 

步骤 5: 在 DemoPages 目录 下 面 新 建 一 个 Razor 代码 文件 ,命名 为 default. cshtml, 并 
在 该 文件 中 输入 以 下 内 容 。 


@page 


<html> 
<body> 
<h3> 欢 迎 </h3> 
<h6 > 这 是 我 们 的 主页 </h6 > 
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</body> 
</htnl > 


Razor 页 面 与 MVC 中 的 Razor 视图 文件 一 样 ,使 用 的 都 是 Razor 标记 语法 ,不 同 的 是 ， 
用 于 MVC 视图 的 Razor 文件 是 没有 @page 指令 的 。 

步骤 6: 运行 应 用 程序 ,在 浏览 器 中 输入 地 址 http: //< 主 机 与 端口 >/default, 结 果 如 
图 16-1 所 示 。 


localhos x I+ 


| © localhost:6210/d 让 
欢迎 


这 是 我 们 的 主页 


图 16-1 自 定义 目录 下 的 Razor 页 面 


实例 348 Razor 页 面 与 页 面 模型 关联 


【导语 】 

Razor 代码 文件 只 要 在 文档 的 首 行 加 上 @page 指令 ,并 且 将 Razor 页 面 放 在 应 用 程序 
所 配置 的 根 目录 下 (默认 为 /Pages) ,就 可 以 在 URL 中 通过 页 面 来 访问 了 。 但 是 ,如 果 页 面 
涉及 相对 复杂 的 业务 逻辑 处 理 , 就 需要 创建 一 个 页 面 模型 类 (Page Model) 来 编写 独立 的 处 
理 代 码 ,使 得 视图 与 代码 分 离 , 便 于 管理 和 维护 。 

页 面 模型 类 需要 从 PageModel 类 (位 于 Microsoft. AspNetCore. Mvc. RazorPages 命名 
空间 ) 派 生 。 页 面 模型 类 中 通过 声明 符合 约定 的 方法 与 视图 逻辑 交互 ,页 面 视图 通过 一 个 名 
为 handler 的 路 由 参数 来 调用 这 些 方 法 。 这 些 具 有 特殊 用 途 的 方法 ,约定 的 命名 规则 如 下 : 


On < HTTP method >< handler name >[ Async] 


此 命名 规则 随 着 ASP. NET Core 版 本 的 更 新 可 能 会 更 改 ,就 目前 版 本 而 言 ,方法 的 命名 包 
括 以 下 几 个 部 分 。 

人 0》 才 法 以 “Oa” 开头 。 

(2) 紧 接着 是 HTTP-method, 例 如 GET、POST、DELETE 等 。 

(3) 然后 是 方法 的 “正式 名 称 ”, 此 名 称 可 以 直接 作为 路 由 参数 handler 的 值 。 

(4) 如 果 是 异步 方法 ,可 以 用 Async 结尾 (Async 是 可 选 的 ) 。 

以 下 命名 均 符合 约定 : 

OnGet 


OnPost 
OnGetStudentInfos 
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OnPostFileAsync 

OnDeletNickID 

当然 ,也 可 以 考虑 从 DefaultPageApplicationModelProvider 类 派生 出 一 个 自 定 义 类 型 ， 
然后 重 写 相关 的 方法 ,自行 定义 新 的 命名 约定 ,但 是 除非 有 特定 的 需求 ,一 般 没 有 必要 这 么 做 。 

页 面 模型 类 还 可 以 公开 属性 ,便于 与 视图 中 的 代码 进行 绑 定 。 由 于 HTTP 往返 通信 是 
无 状态 的 ,在 此 过 程 中 ,属性 的 值 通常 会 丢失 (客户 端 提交 页 面 后 ,页 面 模型 类 中 的 属性 值 会 
丢失 )。 如 果 和 希望 页 面 模 型 类 的 属性 在 HTTP 往返 通信 过 程 中 被 保留 ,可 以 在 属性 上 应 用 
BindPropertyAttribute, 格 式 如 下 。 


[BindProperty] 

public int Age { get; set; } 

在 Razor 页 面 上 可 以 通过 @model 指令 让 视图 与 页 面 模型 类 关联 起 来 ,格式 如 下 。 
(UsersModel 是 页 面 模型 类 ) 


@model UsersModel 


项 目 模板 在 添加 新 的 Razor 页 面 时 ,一般 会 生成 一 个 与 页 面 名 字 相 同 的 代码 文件 ,并 在 
这 个 代码 文件 中 定义 页 面 模 卉 类 。 例 如 ,添加 一 个 名 为 Users. cshtml 的 页 面 ,就 会 生成 一 
个 名 为 Users. cshtml. cs 的 代码 文件 ,里 面包 含 一 个 从 PageModel 类 派生 的 子 类 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 项 目 中 新 建 一 个 目录 ,命名 为 Pages。 

步骤 3: 新 建 一 个 代码 文件 ,定义 一 个 类 ,命名 为 TestModel, 并 且 继 承 PageModel 类 。 


public class TestModel : PageModel 
{ 


步骤 4: 定义 四 个 公共 属性 ,用 于 与 视图 进行 绑 定 。 


BindProperty] 

public string ProductNane { get; set; } 
BindProperty] 

public DateTime ProductDate { get; set; } 
BindProperty] 

public Guid ProductID { get; set; } 
BindProperty] 


ublic string Producthanily { get; set; } 

属性 中 一 般 会 应 用 BindProperty 特性 ,这 是 为 了 在 HTTP 往返 通信 的 过 程 中 保留 属性 
的 值 。 对 于 不 需要 保留 状态 的 属性 ,可 以 不 使 用 BindProperty 特性 。 

步骤 5: 定义 OnGet 方法, 当 以 HTTP-GET 方式 访问 页 面 时 会 调用 该 方法 ,同时 初始 
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化 四 个 属性 。 


public void OnGet() 

{ 
ProductID = Guid. NewGuid(); 
ProductName = "< 未 知 产 品 >"; 
ProductDate = DateTime. Today; 
ProductFamily = "< 未 知 分 类 >"; 

} 


步骤 6: 定义 OnPost 方 法 , 当 页 面 提交 成 功 时 调用 。 


public void OnPost() 
{ 
ViewData[ "msg"] = "恭喜 你 ,提交 成 功 "; 
} 
只 做 演示 ,所 以 处 理 比 较 简 单 ,仅仅 向 ViewData 字典 中 添加 了 一 个 子 项 ， 
ViewData ee 与 模型 代码 之 间 共 享 数据 。 
步骤 7: 新 建 一 个 .cshtml 文档 ,在 文档 顶部 输入 以 下 指令 : 


@page 

@using Demo 

@model TestModel 

@addTagHelper * ,Microsoft.AspNetCore.Mvc. TagHelpers 


Opage 指令 标识 该 视图 用 于 Razor Page 应 用 程序 ; @using 导 人 相关 的 命名 空间 ,与 C# 
语言 中 using 语句 的 作用 相同 ; @model 指令 用 于 设置 关联 的 模型 类 ,此 处 指定 的 是 刚刚 定 
义 的 TestModel 页 面 模型 类 ; @addTagHelper 指令 导 人 HTTP 标记 帮助 器 ,用 以 扩充 
HTML 标签 的 功能 ,格式 为 “< 类 型 >,< 程 序 集 >”,< 类 型 > 也 可 以 用 星 号 ( * ) 表 示 , 即 导入 程 
序 集中 的 所 有 标记 帮助 器 类 型 。 

步骤 8: HTML 文档 内 容 如 下 。 


<!DOCTYPE html > 
<html> 
<head> 
< meta charset = "utf — 8" /> 
<title > 测试 页 面 </title> 
</head> 
<body> 
< form method = "post"> 
产品 编号 :< input type = "text" readonly asp - for = "ProductID"/>< br/> 
产品 名 称 :< input type = "text" asp— for = "ProductName"/>< br/> 
生产 日 期 :< input type = "text" asp- for = "ProductDate"/><br/> 
产品 分 类 :< input asp - for = "ProductFamily"/>< br/> 
<br/><br/> 
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< input type = "subnmit" value = "提交 "人 
</form> 


if (ViewData. ContainsKey("msg" ) ) 


{ 
<p>@ViewData[ "msg" ].ToString()</p> 


} 日 测试 页 面 
四 5 口 © localhosts 页 节 | … 
</body> A| 
ad 产品 编号 : |7ca20dcb-adb5-435c-a0t 


</htnl > 


产品 名 称 : | 新 产品 
asp-for 扩展 标记 用 于 将 HTML 元 素 与 页 面 模 | 生产 日 期 : ,2018-8-7 

型 类 中 的 属性 绑 定 ; 然后 显示 OnPost 方法 中 添加 产品 分 类 : | 辅助 用 品 

到 ViewData 字典 中 的 内 容 。 
步骤 9: 运行 应 用 程序 ,在 浏览 器 页 面 上 输入 相 

关内 容 , 然 后 单 击 “提交 ”按钮 。 由 于 模型 属性 使 用 恭喜 你 ， 提 交 成 功 

了 BindProperty 特性 ,所 以 提交 后 再 次 返回 页 面 

时 ,输入 的 内 容 会 被 保留 ,如 图 16-2 所 示 。 16-2 视图 与 页 面 模型 的 交互 


实例 349 ”Razor Page 应 用 的 路 由 映射 

【导语 】 

当 Razor Page 项 目的 URL 路 径 较 长 的 时 候 ,可 以 使 用 路 由 映射 来 缩短 URL。 举 个 例 
子 .假设 /Pages 目录 下 有 个 Accounts 目录 .Accounts 目录 下 存在 页 面 CheckAll. cshtml , 按 
照 默 认 规则 ,要 访问 该 页 面 其 URL 应 为 http: //demo. org/Accounts/CheckAll. 但 是 经 过 
路 由 映射 后 ,其 URL 可 以 简化 为 http: //demo. org/checks。 

本 实例 将 在 /Pages 目录 下 创建 子 目 录 Users, 再 在 Users 目录 下 创建 两 个 页 面 一 一 
NewUser 与 UserList, 默 认 情 况 下 ,这 两 个 页 面 的 URL 路 径 分 别 为 /Users/NewUser 和 
/Users/UserList ,经 过 路 由 映射 后 ,会 简化 为 /regnew 和 /showlist。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 项 目 中 新 建 目录 Pages 。 

步骤 3: 在 Pages 目录 下 新 建 页 面 Start cshtml, 其 中 HTML 内 容 如 下 。 


@page 


<! DOCTYPE html > 
<html> 
<head> 

<meta charset = "utf — 8" /> 
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<title> 主 页 </title> 
</head> 
<body> 
<div> 
<h2> 主 页 </h2 > 
< h4 > 阳光 驿站 </h4 > 
</div> 
<hr/> 
< div> 
<a href = "/regnew"> 注 册 新 用 户 </a> 
<a href = "/showlist"> 查 看 用 户 列表 </a> 
</div> 
</body> 
</htnl > 


页 面 中 有 两 个 超 链接 ,它们 所 指向 的 路 径 是 经 过 路 由 映射 后 的 路 径 。 
步骤 4: 在 Pages 目录 下 新 建 一 个 子 目录 ,命名 为 Users。 
步骤 5: 在 Users 目录 下 新 建 页 面 NewUser. cshtml。 


@page 


<! DOCTYPE htm] > 
<html> 
<head> 
< meta charset = "utf — 8" /> 
<title> 注 册 </title> 
</head> 
< body> 
< div> 
<p> 
< hl > 新 用 户 注册 </hl > 
</p> 
< div> 
增加 一 个 新 的 用 户 
</div> 
</div> 
</body> 
</htnl> 


步骤 6: 在 Users 目录 下 新 建 一 个 页 面 ,命名 为 UserList cshtml。 
@page 


<! DOCTYPE html > 
<html > 
<head> 

<meta charset = "utf — 8" /> 
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<title > 用 户 列 表 </title> 
</head> 
<body> 
<div> 
<table> 
<thead> 
<tr> 
<th> 用 户 名 </th> 
<th> ID </th> 
</tr> 
</thead> 
<tbody> 
@{ 
for(int i = 1; i<= 10; i++) 
{ 
<tr> 
<td>@string. Format(" 用 户 {0}"， i)</td> 
<td>@i</td> 
</tr> 
} 
} 
</tbody> 
</table> 
</div> 
</body> 
</htnl > 


为 了 演示 ,页 面 中 通过 for 循环 产生 10 条 用 户 记 录 。 
步骤 7: 在 Starup. ConfigureServices 方法 中 注册 与 MVC 相关 的 服务 ,并 且 添 加 路 由 
映射 配置 。 


services. Addiive( ). MddRazorPagesOptions(0 => 

0. Conventions 

. AddPageRoute("/Start", "/") 

. AddPageRoute( "/Users/NewUser", "/regnew") 

. AddPageRoute("/Users/UserList", "/showlist"); 
D); 


AddPageRoute 方法 的 第 一 个 参数 是 真实 的 页 面 地 址 ,第 二 个 参数 是 路 由 之 后 的 新 地 
址 。 如 果 将 某 个 页 面 的 URL 路 由 映射 为 “/” 或 者 空 字 符 串 ,就 可 以 使 该 页 面 变 成 主页 , 即 
在 浏览 器 地 址 栏 中 直接 输入 Web 站 点 的 根 地 址 就 能 定位 到 该 页 面 。 例 如 在 上 面 代码 的 配 
置 中 ,如 果 在 浏览 器 地 址 栏 中 输入 http: //localhost, 实 际 上 会 执行 http: //localhost/Start 
页 面 ; 如 果 输 入 http: //localhost/regnew ,实际 是 执行 了 http: //localhost/users/newuser 
页 面 。 
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实例 350 ”通过 @page 指令 设置 Razor 页 面 的 URL 路 由 


【导语 】 

本 实例 将 演示 一 种 更 简单 的 方法 来 设置 Razor Page 应 用 的 URL 路 由 映射 一 一 使 用 页 
面 视图 的 @page 指令 。 在 (@page 指令 之 后 ,可 以 使 用 字符 串 实例 来 指定 路 由 映射 ,该 路 由 
使 用 的 是 相对 路 径 , 可 以 分 为 两 种 情况 : 
(1) 直接 指定 路 径 段 ,表示 该 路 由 是 相对 于 当前 页 面 的 。 例 如 ,指定 字符 串 “renew”, 当 
前 页 面 名 为 Orders, 那 么 最 终 访问 该 页 面 的 URL 为 http: //demo. net/orders/renew。 

(2) 如 果 指 定 的 字符 是 以 “/” 或 者 “~~/” 开 头 , 则 表示 其 路 由 是 相对 于 根 URL 的 。 例 
如 ,页 面 /users/admin, 而 指定 的 路 由 为 “/admin”, 那么 访问 该 页 面 的 URL 应 为 http: 
//demo. net/admin, 

本 实例 将 对 三 个 页 面 进行 路 由 映射 , 详 见 表 16-1。 

表 16-1 实例 路 由 映射 方案 


映 射 前 映 射 后 
/Main / 
/Funcs/MyMusics /musics 
/Funcs/MyPhotos /photos 
【操作 流程 】 


步骤 1: 新 建 一 个 空白 的 ASP.NET Core Web 应 用 程序 项 目 。 
步骤 2: 在 项 目 中 新 建 一 个 目录 ,命名 为 Pages。 
步骤 3: 在 Pages 目录 下 添加 一 个 Main. cshtml 页 面 。 


@page "/" 


< html > 
<body> 
<h2 > 主页 </h2 > 
<div> 
<a href = "/musics"> 我 的 音乐 </a> 
<a href = "/photos"> 我 的 照片 </a> 
</div> 
</body> 
</htnl > 


在 @page 指令 后 面 的 字符 串 中 指定 “/”, 表 明 从 根 URL 就 可 以 访问 该 页 面 。 
步骤 4: 在 Pages 目录 下 创建 一 个 子 目录 ,名 为 Funcs。 
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步骤 5: 在 Funcs 目录 下 添加 一 个 MyMusics. cshtml 页 面 。 


@page "/musics" 


<html> 
<body> 
< h2 > 我 的 音乐 </h2 > 
</body> 
</htnl > 


步骤 6: 在 Funcs 目录 下 添加 一 个 MyPhotos. cshtml。 
@page "/photos" 


<html> 
<body> 
< h2 > 我 的 照片 </h2 > 
</body> 
</htnl > 


运行 应 用 程序 后 ,输入 根 URL 打开 Main 页 面 (如 图 16-3 所 示 ) , 单 击 页 面 上 的 链接 ,可 
以 跳 转 到 其 他 页 面 (如 图 16-4 所 示 ) 。 


> 加 Ihost50325/photod 了 东 
| 
我 的 照片 
我 的 音乐 我 的 照片 
图 16-3 根 URL 下 的 页 面 图 16-4 跳 转 到 /photos 页 面 


实例 3S1 自 定 义 页 面 的 handler 方法 


【导语 】 

在 页 面 模型 (从 PageModel 类 派生 的 类 ) 中 ,OnGet、OnPost、OnPut 等 方法 会 根据 页 面 
的 请 求 方法 自动 被 调用 。 例 如 以 HTTP-GET 方法 访问 页 面 就 会 调用 OnGet 或 者 
OnGetAsync 方 法 ,以 HTTP-POST 方法 访问 页 面 就 会 调用 OnPost 或 者 OnPostAsync 方法 。 

但 是 这 些 约定 方法 有 时 是 不 能 满足 开发 需求 的 ,因此 框架 允许 自 定义 这 些 方法 的 名 称 ， 
在 路 由 数据 字典 中 ,这 些 页 面 方法 被 命名 为 handler。 上 默认 情况 下 是 通过 URL 的 请 求 参数 
来 调用 页 面 方法 的 ,例如 http: //localhost/students? handler 王 UploadPic, 其 中 ,students 
是 页 面 名 称 ,UploadPic 是 页 面 模型 中 的 方法 名 ,实际 的 方法 命名 应 该 为 OnGetUploadPic。 
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如 果 不 希 望 在 URL 中 出 现 handler 字段 ,可 以 通过 @page 指令 来 自 定义 路 由 ,例如 : 


@page "{handler?}" 


handler 是 路 由 字典 参数 ,必须 写 在 一 对 大 括号 中 ,后 面 的 问号 表示 该 值 为 可 选 ,通过 自 定义 
路 由 后 ,指定 handler 的 URL 可 变 为 http: //localhost/students/ UploadPic。 
在 页 面 模型 中 自 定义 handler 方法 的 命名 规则 如 下 : 


on < HTTP - method >< handler name >[Async] 


方法 以 On 开头 ， 


On 之 后 是 HTTP 请 求 方法 ,例如 Get、Post 等 ,HTTP 请 求 方法 之 后 才 是 


handler 的 名 称 ,Async 后 级 是 可 选 的 ,以 下 命名 都 是 允许 的 。 


OnGetOrder // handler 名 为 0rder, 以 HTTP- GET 方法 访问 
OnPostFeedbackAsync // handler 名 为 Feedback, 以 HTTP - POST 方法 访问 ,异步 方法 
OnGetOrderRsync // handler 名 为 0rder, 异步 方法 

OnDeleteItem // handler 名 为 Item, 以 HTTP - DELETE 方法 访问 
OnGetColors // handler 名 为 Colors, 以 HTTP - GET 方法 访问 


在 实际 使 用 时 ,如 果 需 要 调用 目标 handler, 可 以 使 用 扩展 的 标记 帮助 器 在 运行 时 自动 


生成 URL, 例 如 


,asp-page 标记 属性 指定 要 执行 的 页 面 , 当前 页 面 可 以 忽略 ; asp-page- 


handler 标记 属性 指定 要 执行 的 handler 的 名 称 。 


【操作 流程 】 
步骤 1: 新 下 


一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 


步骤 2: 在 项 目 中 新 建 Pages 目录 。 
步骤 3: 在 Pages 目录 下 面 添 加 test. cshtml 页 。 
步骤 4: 在 test 页面 顶 部 ,添加 以 下 指令 声明 。 


@page "{handler?}" 
@addTagHelper * ,Microsoft.AspNetCore.Mvc.TagHelpers 


@model Demo. 


@page 指令 


TestModel 


设置 查找 handler 的 路 由 , @addTagHelper 指令 用 于 导入 HTML 标记 扩 


展 帮 助 器 类 型 ,本 实例 中 将 导入 Microsoft. AspNetCore. Mvc. TagHelpers 程序 集中 的 所 有 


帮助 器 ,@model 
步骤 $: test 


< html > 
<body> 


指令 设置 与 页 面 关 联 的 模型 类 ,用 于 定义 页 面 处 理 方法 。 
页 面 的 HTML 文档 如 下 。 


< form method = "post"> 


用 户 名 : 

< input type = "text" name = "username" />< br /> 
密码 : 

< input type = "password" name = "password"/>< br/> 
<div> 
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< input type = "submit" value = "公开 登录 " asp - page - handler = "LoginPublic"/> 
< input type = "subnit" valve = "隐身 登录 " asp - page handler = "LoginHidden"/> 
</div> 
</form> 
</body> 
</htnl > 


在 两 个 提交 按钮 上 ,通过 asp-page-handler 标记 属性 来 指定 要 调用 的 方法 ,由 于 处 理 的 
方法 将 在 当前 页 面 的 模型 类 中 定义 ,所 以 不 需要 使 用 asp-page 标记 属性 。 在 form 标记 中 ， 
需要 为 两 个 文本 的 输入 元 素 设置 name 值 , 这 样 当 提交 页 面 时 会 自动 将 用 户 输入 的 内 容 传 
递 给 页 面 模型 中 处 理 方法 的 参数 ,前提 是 HTML 元 素 的 name 值 必须 与 方法 参数 的 名 称 匹 配 。 

步骤 6: 定义 页 面 模型 类 ,以 及 两 个 handler 方法 。 


public class TestModel : PageModel 


{ 
public ActionResult OnPostLoginPublic(string username, string password) 
{ 
string msg = $ "你 以 公共 方式 登录 ,输入 的 用 户 名 为 {username}, 密码 为 {password}"; 
return Content (msg); 
} 
public ActionResult OnPostLoginHidden( string username, string password) 
{ 
string msg = $ "你 以 隐身 方式 登录 ,输入 的 用 户 名 为 {username}, 密码 为 {password}"; 
return Content (msg); 
} 
} 


方法 参数 的 名 字 要 与 页 面 视 图 上 < input > 元 素 的 name 值 相同 ,才能 传递 内 容 , 即 分 别 


为 username 和 password。 


注意 : 调用 两 个 handler 方法 后 均 返 回 HTML 文本 。 在 实际 开发 中 ,不 可 能 将 用 户 输入 的 
密码 以 明文 的 方式 展现 ,此 处 仅仅 是 演示 。 


步骤 7: 运行 应 用 程序 , 先 输入 用 户 名 和 密码 ,然后 可 以 分 别 单 击 两 个 按钮 提交 ,如 
图 16-5 和 图 16-6 所 示 。 


四 localh x 

< 日 |Olkahe0] 六 | 史 上 oaahos x 辆 | a 
用 户 名 [arm € > 0 AQ |O kbotoooreg] | 尼 | 
密码 : [ee 你 以 隐身 方式 登录 ， 输 入 的 用 户 名 为 admin， 窗 码 为 12345 
公开 请 录 


图 16-5 输入 用 户 名 和 密码 图 16-6 ”提交 后 的 处 理 结果 
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浏览 器 打开 test 页 面 后 ,其 产生 的 两 个 提交 按钮 的 HTML 标签 如 下 : 


< input type = "submit" value = "公开 登录 " formaction = "/test/LoginPublic" /> 
< input type = "submit” value = "隐身 登录 " formaction = "/test/LoginHidden" /> 


formaction 属性 中 的 内 容 就 包含 相应 的 handler 名 称 。 


16.2 MVC( 模 型 -框架 -视图 ) 


实例 352 ”为 全 局 路 由 字段 分 配 默认 值 


【导语 】 

MVC 应 用 程序 的 URL 路 由 有 两 种 定义 方式 : 中 在 Startup. Configure 方法 中 通过 
UseMvc 方法 设置 的 路 由 规则 会 应 用 到 整个 应 用 程序 中 ; 四 在 每 个 控制 器 类 以 及 其 成 员 方 
法 上 通过 Route 特性 设置 的 路 由 为 局 部 规则 , 仅 对 当前 控制 器 有 效 。 

URL 路 由 以 字符 串 的 形式 表示 ,其 中 有 三 个 占 位 符 ,它们 属于 路 由 字典 中 的 Key, 因 此 
这 三 个 值 比较 特殊 ,需要 写 在 一 对 大 括号 中 ,三 个 占 位 符 如 下 。 

(1) {area} : 表示 MVC 应 用 程序 中 的 “ 域 ”, 通 常用 于 划分 程序 功能 ,小 型 项 目 可 以 不 
使 用 。 

(2) {controller) : 表示 控制 器 的 名 称 。 如 果 控 制 器 类 的 名 称 带 有 ”Controller” 后 缀 , 则 
该 后 级 会 被 去 掉 。 例 如 , 某 控制 器 类 命名 为 PublishController ,那么 在 使 用 URL 时 ， 
controller 字段 的 值 应 该 为 Publish。 

(3) {action) : 控制 器 类 中 的 要 执行 的 方法 名 称 。 

此 外 ,还 可 以 自 定义 参数 名 ,例如 : 


{controller}/{action} /{id?} 
其 中 ,id 是 传递 给 某 个 action 方法 的 参数 的 名 称 , 假 设 要 调用 Publish 控制 器 中 的 Review 
方法 ,参数 id 为 105, 那 么 请 求 的 URL 应 为 http: //localhost/publish/review/105。{id} 中 
的 问号 (?) 表 示 该 字段 是 可 选 的 ,如 果 不 需要 提供 参数 值 ,那么 请 求 的 URL 就 是 http: // 
localhost/publish/review,。 

但 在 实际 开发 中 ,一 般 不 应 该 让 用 户 记 住 这 么 长 的 URL, 对 于 应 用 程序 主页 ,只 要 在 浏 
览 器 地 址 栏 中 输入 根 URL 就 能 访问 默认 页 面 ,因此 MVC 框架 允许 为 URL 路 由 中 的 字段 
值 分 配 默认 值 , 例 如 : 


{controller = Home}/{action= Index} 


当 用 户 输入 http: //someweb. com 时 ,实际 上 就 执行 了 Home 控制 器 中 的 Index 方法 , 即 
http: //someweb. com/ Home/Index。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP.NET Core Web 应 用 程序 项 目 。 


则 分 配 一 个 名 称 ,该 名 称 可 以 自 定义 ,主要 用 来 唯一 标识 本 路 由 规则 。 在 本 实例 中 , 设 定 的 
默认 控制 器 名 为 Demo, 默 认 的 执行 方法 名 为 Default。 
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步骤 2: 在 Startup. ConfigureServices 方法 中 调用 AddMvc 添加 相关 的 服务 。 
services. RddMvc( ) 7 
步骤 3: 在 Startup. Configure 方法 中 使 用 MVC 相关 的 中 间 件 。 


app. UseMvc(I => 
{ 

r. MapRoute( "main", "{controller = Demo}/{action = Default}"); 
DD); 


在 调用 UseMve 方法 时 ,可 以 通过 委托 设置 URL 路 由 , MapRoute 方法 需要 为 路 由 规 


步骤 4: 在 项 目 中 添加 一 个 类 ,命名 为 DemoController(Controller 后 缀 是 可 选 的 ,属于 


命名 约定 ) ,并且 该 类 从 Controller 类 派生 ,表示 一 个 控制 器 。 


public class DemoController : Controller 
{ 
public ActionResult Default() 
{ 
return Content(" 这 是 一 个 Web 应 用 "); 
} 
} 


Default 即 Action 方法 , 它 返回 一 个 字符 串 内 容 。 
步骤 5: 运行 应 用 程序 ,直接 输入 根 URL ,就 能 访问 到 Demo 控制 器 了 ,例如 http: // 


localhost: 7603 。 


对 于 


实例 353 ”局 部 的 URL 路 由 

【导语 】 

在 Startup. Configure 方法 中 定义 的 路 由 规则 是 全 局 的 ,适用 于 整个 应 用 程序 。 但 有 时 
FF 部 分 控制 器 ,开发 者 需要 使 用 特殊 的 路 由 规则 , 即 局 部 的 URL 路 由 ,主要 是 通过 在 控 


制 器 类 或 者 控制 器 类 的 方法 成 员 上 附加 Route 特性 (RouteAttribute 类 ) 来 实现 的 。 局 部 路 
由 规则 仅 在 Route 特性 所 应 用 的 目标 对 象 上 有 效 , 它 的 优先 级 高 于 全 局 路 由 规则 。 


在 全 局 路 由 规则 中 ,controller、action 等 特殊 字段 是 在 一 对 大 括号 中 的 ,但 在 局 部 路 由 


规则 中 ,使 用 的 是 中 括号 ,例如 以 下 形式 。 


[controller]/[action] 
但 是 ,参数 名 称 依然 要 使 用 大 括号 括 起 来 ,例如 : 


[controller]/[action]/{id?} 


其 中 ,id 是 参数 ,问号 表示 该 值 是 可 选 的 。 
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局 部 路 由 也 可 以 使 用 * 硬 编码 ”的 URL, 即 不 使 用 controller、action 等 占 位 符 , 而 是 指定 
固定 的 URL 路 径 , 例 如 : 


/users 


此 时 ,不 管 目标 控制 器 叫 什么 名 称 ,只 要 使 用 http: //abc. org/users 就 能 访问 该 控制 器 。 

同时 ,Route 特性 也 支持 URL 的 “分 层 ” 组 合 。 假 设 在 某 控制 器 上 应 用 了 路 由 规则 
/students, 然 后 在 控制 器 类 的 某 个 方法 上 应 用 路 由 规则 getinfo, 那 么 完整 的 URL 就 变 成 
http: //abc. org/students/getinfo。 

【操作 流程 】 

步骤 1: 新建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Startup. ConfigureServices 方法 中 注册 与 MVC 功能 有 关 的 服务 。 


public void ConfigureServices(IServiceCollection services) 
{ 
services. RddMvc() 


} 
步骤 3: 在 Startup. Configure 方法 中 使 用 MVC 中 间 件 。 


public void Configure( IApplicationBuilder app, IHostingEnvironment env) 
{ 

app. UseMvc(); 
} 


本 实例 将 使 用 局 部 路 由 规则 ,因此 在 调用 UseMvc 方法 时 不 需要 定义 路 由 规则 。 
步骤 4: 定义 第 一 个 控制 器 ,命名 为 Main, 包 含 两 个 操作 方法 。 


[Route("[controller]/[action]")] 
public class MainController : Controller 
| 
public ActionResult Rbout() 
return Content(" 关 于 本 站 "); 
} 


public ActionResult Home( ) 
{ 
return Content ("官方 主页 "); 


} 

访问 该 控制 器 时 ,会 用 控制 器 的 名 称 蔡 换 URL 路 由 规则 中 的 [controller] 与 [action] 。 

步骤 5: 定义 第 二 个 控制 器 Product, 它 将 使 用 不 带 占 位 符 的 URL, 并 且 Route 特性 将 
分 别 应 用 到 类 和 操作 方法 上 。 
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[Route("/products")] 
public class ProductController : Controller 
{ 

[Route("list")] 

public ActionResult GetList() 

{ 

return Content ("产品 列表 "); 

} 

} 


访问 GetList 方法 的 URL 是 固定 的 , 即 http: //localhost/products/list。 
步骤 6: 运行 应 用 程序 ,可 通过 以 下 几 个 URL 来 做 访问 测试 。 
http://localhost:17120/main/about 


http://localhost:17120/main/home 
http://localhost:17120/products/list 


实例 354 ” 自 定义 视图 文件 的 查找 位 置 

【导语 】 

在 MVC 的 控制 器 中 调用 不 带 参 数 的 View 方法 时 ,将 返回 与 Action 名 称 相同 的 视图 。 
框架 查找 视图 文件 的 默认 路 径 有 以 下 三 个 : 


/Views/{1}/{0}.cshtml 

/Views/Shared/{0}.cshtnl 

/Pages/Shared/{0}.cshtnl 
路 径 中 包含 字符 串 的 格式 占 位 符 , 和 {1} 表示 Controller 的 名 称 , {0) 表 示 Action 的 名 称 。 假 
设 访问 Goods 控制 器 中 的 Reset 方法 ,那么 在 返回 视图 时 ,MVC 框架 将 查找 如 下 文件 。 


/Views/Goods/Reset.cshtml 

Shared 目录 下 的 视图 一 般 用 于 布局 页 (页 面 的 母 版 ) 或 者 可 以 在 多 个 控制 器 中 共用 的 
视图 (例如 显示 错误 信息 的 页 面 )。 

对 于 带 有 Area 的 MVC 项 目 .其 视图 查找 路 径 为 : 


/Areas/{2}/Views/{1}/{0}.cshtml 
/Mreas/{2}/Views/Shared/{0}. cshtml 
/Views/Shared/{0}.cshtnl 
/Pages/Shared/{0}.cshtnl 


此 处 的 {2} 是 Area 的 占 位 符 .11} 是 Controller 的 占 位 符 ,{0} 是 Action 的 占 位 符 。 
RazorViewEngineOptions 类 公开 的 AreaViewLocationFormats 属性 和 ViewLocationFormats 


属性 都 是 用 于 配置 视图 文件 的 查找 路 径 的 ,它们 均 为 字符 串 列 表 , 可 以 添加 多 个 查找 路 径 。 
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本 实例 将 演示 将 视图 文件 的 查找 目录 从 Views 改 为 DemoViews。 

【操作 流程 】 

步骤 1: 新建 一 个 空白 ASP.NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Startup. ConfigureServices 方法 中 添加 与 MVC 相关 的 服务 ,并 且 调 用 
AddRazorOptions 方法 配置 视图 查找 路 径 。 


services. RddMvc( ). AddRazorOptions(o => 
{ 

// 清除 默认 路 径 

o. ViewLocationFormats. Clear( ); 

// 添加 自 定义 的 路 径 

o. ViewLocationFormats. Add("/DemoViews/{1}/{0}" + RazorViewEngine.ViewExtension); 

o. ViewLocationFormats. Add("/DemoViews/Shared/{0}" + RazorViewEngine. ViewExtension); 
DD; 


RazorViewEngine. ViewExtension 字段 能 自动 返回 视图 文件 的 扩展 名 。 
步骤 3: 在 Startup. Configure 方法 中 使 用 与 MVC 相关 的 中 间 件 。 


app. UseMvc( ); 
步骤 4: 定义 控制 器 类 ,此 类 包含 两 个 操作 方法 一 一 Testl 和 Test2。 


[Route("[controller]/[action]")] 
public class SampleController :; Controller 
{ 
public IActionResult Test1() => View(); 
public IActionResult Test2() => View(); 
} 


步骤 5: 在 项 目 中 创建 DemoViews 目录 ,再 在 DemoViews 目录 下 创建 Sample 目录 
(与 控制 器 名 称 相同 )。 

步骤 6: 在 Sample 目录 下 添加 两 个 . cshtml 文件 ,命名 都 与 Sample 控制 器 的 两 个 操作 
方法 匹配 一 一 Testl. cshtml 和 Test2. cshtml 。 


// Test1. cshtml 
<html> 
<body> 
<div> 
<h2> 视 图 1 </h2 > 
</div> 
</body> 
</htnl> 


// Test2. cshtml 
<html> 
<body> 
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<div> 
<h2> 视 图 2 </h2 > 

</div> 
</body> 
</htnl > 
步骤 7: 运行 应 用 程序 ,分 别 使 用 以 下 URL 可 以 访问 到 Sample 控制 器 的 两 个 操作 

方法 。 

http://localhost:1909/sample/test1 
http://localhost:1909/sample/test2 


实例 355 根据 URL 查询 参数 返回 不 同 的 视图 


【导语 】 

控制 器 的 View 方法 有 以 下 几 种 方法 返回 视图 : 

(1) 无 参数 调用 。 这 种 情况 下 ,视图 文件 的 名 称 必须 与 当前 操作 方法 的 名 称 相同 , 即 
Action 的 名 称 与 视图 文件 名 一 致 

(2) 指定 视图 名 称 (不 包含 路 径 与 文件 扩展 名 )。 如 果 视 图 文件 位 于 以 当前 控制 器 命名 
的 目录 下 ,那么 指定 视图 名 称 时 不 需要 指定 文件 扩展 名 。 例 如 ,视图 文件 名 为 
OrderDetails. cshtml ,那么 只 要 指定 OrderDetails 就 能 找到 该 视图 。 

(3) 包含 路 径 与 文件 扩展 名 。 当 视图 文件 不 位 于 以 当前 控制 器 命名 的 目录 下 ,或 者 不 
在 设 定 的 查找 路 径 内 , 则 需要 指定 视图 文件 的 完整 路 径 , 例如 一 /Views/Something. 
cshtml 。 

本 实例 将 演示 通过 URL 的 查询 参数 判定 应 该 返回 哪个 视图 。 实 例 中 将 用 到 三 个 视图 
文件 ,Default. cshtml 文件 位 于 /Views 目录 下 ,Preview. cshtml 和 Pagedview. cshtml 两 个 
文件 均 位 于 与 Demo 控制 器 同名 的 目录 下 。 如 果 请 求 参数 mode 的 值 为 preview, 则 使 用 
Preview. cshtml 视图 文件 ; 如 果 参 数 mode 的 值 为 pagedview, 则 使 用 Pagedview. cshtml 视 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Startup. ConfigureServices 方法 中 注册 与 MVC 相关 的 服务 。 


services. AddMvc( ) 7 
步骤 3: 在 Startup. Configure 方法 中 使 用 与 MVC 相关 的 中 间 件 。 


app. UseMvc(route -> 
{ 
route. MapRoute("app", "{controller}/{action}"); 


D; 
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步骤 4: 在 项 目 中 新 建 Views 目录 。 
步骤 5: 在 Views 目录 下 添加 一 个 名 为 Default. cshtml 的 视图 文件 。 


<html> 
<body> 
< hl > 默认 视图 </hl > 
</body> 
</htnl > 


步骤 6: 在 Views 目录 下 新 建 一 个 目录 .命名 为 Demo( 与 控制 器 名 称 一 致 ) 。 
步骤 7: 在 Demo 目录 下 添加 两 个 视图 文件 。 


// Preview. cshtml 
<html> 
<body> 

< hl > 预览 视图 </hl > 
</body> 
</htnl > 


// Pagedview. cshtml 


<html > 
< body> 
< hl > 分 页 视图 </hl > 
</body> 
</htnl > 


步骤 8: 定义 控制 器 类 。 


public class DemoController : Controller 
{ 
public ActionResult GetInfo( [FromQuery]string mode) 
{ 
if(node == "preview") 
. 
return View( "Preview"); 
} 
else if(mode == "pagedview") 
{ 


return View( "Pagedvien" ) ; 


} 
return View("~/Views/Default. cshtml"); 


} 
mode 参数 的 值 将 从 URL 查询 参数 (在 URL 中 以 问号 开头 的 部 分 ) 中 提取 ,所 以 在 声 
明 参 数 时 要 加 上 FromQuery 特性 ,否则 无 法 提取 。 
Preview 视图 与 Pagedview 视图 都 位 于 与 控制 器 同名 的 目录 中 ,因此 调用 View 方法 时 
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不 需要 指定 路 径 与 扩展 名 ; 但 Default 视图 需要 明确 文件 路 径 。 


步骤 9: 运行 应 用 程序 ,可 以 在 浏览 器 中 尝试 用 [SANS XGO 
以 下 地 址 进行 访问 。 el 


http://localhost:9105/demo/getinfo?mode = preview 


1 各 | 
http://localhost:9105/demo/getinfo?mode = pagedview [| 


http://localhost:9105/demo/getinfo?mode = 
http://localhost:9105/demo/getinfo 


效果 如 图 16-7 所 示 。 


实例 356 自 定义 的 控制 器 类 


【导语 】 

定义 控制 器 ,不 仅 可 以 继承 Controller 类 ,还 可 以 自 定义 一 个 类 ,然后 将 其 作为 控制 器 。 
方法 是 在 类 声明 上 应 用 Controller 特性 (ControllerAttribute 类 ) ,然后 该 类 所 公开 的 公共 方 
法 将 被 视 为 操作 方法 ( 即 Action)。 

本 实例 将 演示 一 个 简单 的 MVC 应 用 程序 ,使 用 一 个 独立 的 自 定义 类 作为 控制 器 ,并 在 
操作 方法 上 返回 视图 (方法 返回 的 实际 类 型 为 ViewResult) 。 

【操作 流程 】 

步骤 1: 新建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Startup 类 中 ,分 别 配 置 与 MVC 相关 的 服务 组 件 和 中 间 件 。 


16-7 根据 URL 参数 筛选 视图 


public void ConfigureServices( IServiceCollection services) 
{ 


services. AddMvc( ); 


; 
public void Configure( IApplicationBuilder app) 
{ 
app. UseMvcWithDefaultRoute( ); 
} 


UseMvecWithDefaultRoute 方法 的 作用 与 UseMvc 方法 一 样 ,只 是 它 会 添加 默认 的 路 
由 规则 , 即 {controller 二 Home}/{action 二 Index}/{id?)。 
步骤 3: 自 定义 一 个 类 ,命名 为 MyController, 即 控制 器 为 My。 


[Controller] 
public class MyController 
{ 
public ActionResult Index() 
{ 
ViewResult res = new ViewResult 


和 
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ViewNane = "Default" 
}; 


return res; 


注意 : 若 将 未 从 Controller 类 派生 的 类 作为 控制 器 使 用 ,必须 应 用 ControllerAttribute。 
由 于 自 定 义 的 类 中 没有 View 方法 ,因此 在 操作 方法 中 需要 手动 创建 ViewResult 实 
倒 ,并 为 ViewName 属性 赋值 。 


步骤 4: 在 项 目 中 新 建 Views 目录 。 
步骤 5: 在 Views 目录 下 创建 My 子 目录 (与 控制 器 同名 ) 。 
步骤 6: 在 My 目录 下 添加 视图 文件 Default. 


el localhost x 
cshtml。 
€¢ DO © localhos 六 [3 | … 
< html > 
欢迎 访问 本 站 
< hl > 欢迎 访问 本 站 </hl > 人 Ia 
<hr/> 
< h4>—— ASP. NET Core Web Dev </h4 > 
</body> —— ASP.NET Core Web Dev 
</htnl > 


步骤 7: 运行 应 用 程序 ,在 浏览 器 中 访问 
http: //localhost/my/index, 可 以 看 到 如 图 16-8 


图 16-8 自 定义 控制 器 类 返回 的 视图 


所 示 的 结果 。 
实例 357 阻止 控制 器 中 的 方法 被 公开 为 Action 方法 
【导语 】 


在 控制 器 类 中 ,默认 会 将 所 有 公共 方法 视 为 操作 方法 (MVC 中 的 Action) ,但 在 某 些 特 
殊 情况 下 ,不 希望 某 些 方法 被 作为 Action 方法 公开 。 在 方法 上 应 用 NonAction 特性 之 后 ， 
该 方法 将 被 禁止 作为 Action 方法 公开 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Startup 类 中 ,注册 MVC 服务 并 启用 中 间 件 。 


public void ConfigureServices(IServiceCollection services) 
{ 
services. AddMvc( ); 


} 


public void Configure( IApplicationBuilder app) 
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‘ 
app.UseMvcWithDefaultRoute( ) ; 
} 


步骤 3: 定义 控制 器 类 ,类 中 包含 两 个 方法 ,其 中 SayHello 方法 将 被 禁止 作为 Action 
方法 公开 。 


public class HomeController : Controller 
{ 
public IActionResult Index() 
{ 
return View(); 


} 


[NonAction] 
public string SayHello() 
{ 
return "你 好 ,世界 "; 
} 
¥ 


步骤 4: 当 运 行 应 用 程序 时 ,访问 http: //localhost/home/sayhello 将 返回 404 错误 ,这 
表明 SayHello 方法 已 被 禁止 公开 ,无 法 通过 URL 访问 ; 一 旦 去 掉 NonAction 特性 ， 
SayHello 方 法 就 能 够 顺利 访问 。 


实例 358 重 命 名 Action 方法 


【导语 】 

MVC 框架 默认 指定 Action 方法 的 名 称 与 成 员 方 法 的 名 称 一 致 ,但 是 如 果 控 制 器 类 的 
成 员 方法 上 应 用 了 ActionName 特性 (ActionNameAttribute 类 ) 并 指定 了 另 一 个 名 称 ,那么 
Action 方法 的 名 称 将 不 再 与 成 员 方法 名 称 相 同 。 如 果 Action 方法 被 重 命名 了 ,与 Action 
方法 相对 应 的 视图 文件 也 要 使 用 ActionName 特性 所 指定 的 名 称 , 而 不 是 成 员 方 法 的 名 称 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Startup 方法 中 注册 与 MVC 相关 的 服务 ,并 启用 中 间 件 。 


public void ConfigureServices(IServiceCollection services) 
{ 
services. RddMvc() 


} 


public void Configure( IApplicationBuilder app) 
{ 

app. UseMvcWithDefaultRoute( ); 
} 
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步骤 3: 定义 控制 器 ,类 名 为 Home, 其 中 包含 成 员 方法 GetItems。 


public class HomeController : Controller 
{ 
[ActionName( "get — items")] 
public ActionResult GetItens() 
return View(); 
} 
} 


Action 的 实际 名 称 已 变 为 get-items, 而 不 是 GetItems, 所 以 请 求 的 URL 应 为 http: // 
somehost/home/ getritems。 

步骤 4: 在 项 目 中 新 建 Views 目录 。 

步骤 5: 在 Views 目录 中 新 建 Home 子 目 录 。 

步骤 6: 在 Home 目录 中 添加 视图 文件 ,文件 名 为 get-items. cshtml。 


< html > 
<body> 
> 
@{ 
For (int a = Ta<57af+) 
{ 
<1i>@string. Format(" 项 目 {0}", a)</1i> 
} 
} 
</ul> 
</body> 
</htnl > 


注意 : 视图 的 名 称 不 能 再 使 用 GetItems 了 ,因为 Action 已 经 被 重 命名 了 。 


步骤 7: 运行 应 用 程序 ,在 浏览 器 中 访问 http: //localhost: 4800/home/get-items, 结 
果 如 图 16-9 所 示 。 


口 eon x 蒜 = 亲 一 冯 


€¢ DO © alhost4800/home/get-itemd 


, 项 目 1 
, 项 目 2 
, 项 目 3 
, 项 目 4 


图 16-9 访问 重 命名 后 的 Action 方法 
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实例 359 使 用 布局 页 


【导语 】 

布局 页 可 作为 项 目 内 各 视图 的 母 版 ,用 于 排版 被 重复 使 用 的 内 容 , 例 如 版 权 信息 \ 网 站 
Logo、 导 航 栏 等 。 使 用 布局 页 的 优点 是 可 以 避免 大 量 重复 性 的 工作 。 

在 布局 页 视图 文件 中 ,可 以 在 内 容 页 出 现 的 位 置 调 用 RenderBody 方法 来 生成 占 位 符 ， 
当 某 个 内 容 页 应 用 了 当前 布局 页 后 ,内 容 页 的 HTML 元 素 将 出 现在 调用 RenderBody 方法 
的 地 方 。 

在 内 容 视图 文件 中 ,通过 Layout 属性 (在 RazorPageBase 类 中 公开 ) 可 以 设置 布局 页 的 
名 称 。 如 果 布 局 页 位 于 可 以 被 查找 到 的 位 置 (例如 /Views/Shared 目录 下 ) ,那么 是 不 需要 
指定 路 径 和 扩展 名 ; 否则 就 要 明确 指定 布局 页 的 文件 路 径 和 扩展 名 ,这 与 视图 文件 的 查找 
方式 相似 。 一 般 在 命名 有 特殊 用 途 的 视图 文件 时 都 会 以 下 面 线 开头 ,所 以 布局 页 通常 命名 
为 _Layout. cshtml。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 项 目 目录 下 新 建 一 个 Views 目录 。 

步骤 3: 在 Views 目录 下 再 新 建 一 个 Shared 目录 。 

步骤 4: 在 Shared 目录 下 添加 布局 视图 文件 ,命名 为 _Layout. cshtml。 


<!DOCTYPE html > 
<html> 
<head> 
< meta name = "viewport" content = "width = device - width" /> 
<title>@ViewBag. Title </title> 
</head> 
<body> 
< div style = "height:100px; background ~ color:slateblue;position:relative"> 
<p style = "color:white; font - size:40px; position:absolute;margin - left:15px"> 
清新 小 站 
</p> 
</div> 
<div style= "margin - top:35px;margin— botton:45px"> 
@RenderBody( ) 
</div> 
<div> 
<hr/> 
2018 - 2018 版 权 所 有 
</div> 
</body> 
</htnl > 
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步骤 5: 在 Views 目录 下 新 建 Test 目录 (控制 器 名 为 Test) 。 
步骤 6: 在 Test 目录 下 添加 Default. cshtml 视图 。 


@!{ 

Layout = " Layout"; 
} 
<div> 

网 站 主页 


</div> 


只 有 明确 设置 Layout 属性 后 ,视图 才能 使 用 布 | 电 vemos x 图 - 0 x 


局 页 。 
步骤 7: 定义 Test 控制 器 。 


public class TestController : Controller 三 立 | 证 
{ /月 下 /J\y 
public ActionResult Default() 
{ 网 站 主页 


return View(); 
} 
} © 2018 - 2018 版 权 所 有 
步骤 8: 运行 应 用 程序 ,布局 页 与 内 容 页 合并 后 
的 效果 如 图 16-10 所 示 。 


实例 360”_ViewStart 视图 与 _ViewImports 视图 


【导语 】 

这 两 个 视图 文件 的 名 称 都 以 下 面 线 开头 ,表示 它们 有 特殊 用 途 , 一 般 不 向 客户 端 公 开 。 
这 两 个 视图 不 用 于 定义 可 视 化 内 容 , 而 是 用 于 声明 一 些 在 视图 中 重复 使 用 的 指令 。 

_ViewImports 视图 专门 用 于 导入 命名 空间 , System、System. Threading. Tasks、 
Microsoft. AspNetCore. Mvc 等 命名 空间 中 的 类 型 在 视图 中 比较 常用 ,统一 在 
_ViewImports 视图 中 导入 ,不 需要 每 个 视图 文件 都 写 一 遍 using 指令 。 

_ViewStart 视图 用 来 放置 在 各 个 视图 中 都 可 能 重复 使 用 的 指令 (@page 指令 除外 ,这 
个 指令 必须 写 在 每 个 Razor Page 文件 的 第 一 行 ), 例 如 引用 布局 页 (一 般 命名 为 _Layout)， 
可 能 在 每 个 视图 文件 中 都 要 写 这 些 指令 ,将 它们 一 次 性 写 到 _ViewStart 视图 中 ,后 面 就 不 
用 重复 去 写 了 。 在 执行 每 个 视图 文件 时 都 会 先 执行 _ViewStart 视图 中 的 代码 。 

_ViewStart 和 _ViewImports 并 不 要 求 放 置 到 /View/Shared 目录 下 ,实际 上 ,它们 可 以 
放 在 任何 存 有 视图 文件 的 目录 下 ,只 对 当前 目录 及 于 目录 下 的 视图 起 作用 。 举 个 例子 ,假设 
有 Data 控制 器 , 它 包含 Delete 和 Update 两 个 视图 。 


图 16-10 应 用 了 布局 页 的 视图 


/Views 
/Data 
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/_ViewStart. cshtml 

/_ViewImports. cshtml 

/Delete. cshtml 

/Update. cshtml 
/Shared 

/OpenList. cshtml 


_ViewStart 和 _ViewImports 视图 位 于 Data 目录 下 ,它们 只 对 Delete 和 Update 两 个 
视图 起 作用 ,对 OpenList 视图 不 起 作用 。 


【操作 流程 】 
步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 
步骤 2: 定义 Demo 控制 器 ,其 中 包含 五 个 操作 方法 ,默认 对 应 五 个 视图 。 


public class DemoController : Controller 

{ 
public ActionResult Index() => View(); 
public ActionResult Desc() => View(); 
public ActionResult News() => View(); 
public ActionResult Products() => View(); 
public ActionResult ContactUs() => View(); 

} 


步骤 3: 在 项 目 中 新 建 Views 目录 。 


步骤 4: 在 Views 目录 下 新 建 Shared 子 目 录 ,并 在 其 中 存放 布局 视图 _Layout。 


@addTagHelper * ,Microsoft.AspNetCore.Mvc. TagHelpers 
<! DOCTYPE htm]l > 


<html> 
<head> 
< meta name = "viewport" content = "width = device 一 width" /> 
<title>@ViewBag. Title </title> 
</head> 
<body> 
<nav> 
<aasp- controller = "Demo" asp - action = "Index"> 主 页 </a> 


<aasp- controller " asp - action = "Desc"> 公 司 简介 </a> 
<aasp— controller asp 一 action = "News"> 新 闻 </a> 
<a asp - controller "asp - action = "Products"> 产 品 信息 </a> 
<a asp - controller = "Demo" asp - action = "ContactUs"> 联 系 我 们 </a> 

</nav> 

<div> 
@RenderBody( ) 

</div> 

</body> 


</htnl> 
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< nav > 标签 所 定义 的 导航 栏 中 包含 指向 五 个 视图 的 链接 ,此 处 可 以 使 用 asp-controller 
和 asp-action 两 个 标签 帮助 器 使 框架 自动 生成 导航 的 URL。 

步骤 5: 在 Views 目录 下 新 建 Demo 目录 ,对 应 控制 器 Demo。 

步骤 6: 在 Demo 目录 下 添加 五 个 视图 文件 ,对 应 Demo 控制 器 中 的 五 个 Action, 详 见 
代码 清单 16-1 。 


代码 清单 16-1 五 个 视图 的 HTML 文档 


// Index. cshtml 
<h3> 主 页 </h3> 


// Desc. cshtml 
<h3 > 公司 简介 </h3 > 


// News. cshtml 
<h3 > 公司 新 闻 </h3 > 


// Products. cshtml 
<h3 > 产品 概览 </h3 > 


// ContactUs. cshtml 
< h3 > 联系 我 们 </h3 > 
步骤 7: 在 Demo 目录 下 添加 _ViewImports 视图 文件 ,导入 可 能 会 被 用 到 的 命名 空间 。 


@using System 
@using Microsoft. AspNetCore. Mvc 
@using Microsoft. AspNetCore. Mvc. TagHelpers 


步骤 8: 在 Demo 目录 下 添加 _ViewStart 视图 文件 ,并 写 和 人 会 在 视图 中 被 重复 使 用 的 代码 。 
@{ 


Layout = "_Layout"; 


} 
@addTagHelper * ,Microsoft.AspNetCore.Mvc. TagHelpers 


步骤 9: 运行 应 用 程序 ,结果 如 图 16-11 和 图 16-12 所 示 。 


上 localhost 上 oaihost x 国 E39 
€ ©O | @ lochostoor 太 故国 € ©O |o kohotoo/pem Dg] 言 | 
主页 公司 简介 新 闻 产品 信息 联系 我 们 主页 公司 简介 新闻 产品 信息 联系 我 们 
主页 产品 概览 


图 16-11 示例 应 用 的 主页 图 16-12 示例 应 用 的 产品 视图 
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实例 361 向 视图 传递 模型 对 象 


【导语 】 
在 实际 应 用 中 ,经 常 需要 在 控制 器 中 向 视图 传递 数据 ,这 些 数 据 可 以 称 为 “模型 ” 


(Model) ,MVC 框架 中 的 “M” 指 的 就 是 Model。 


模型 可 以 是 任意 类 型 ,一 般 是 自 定义 的 类 ,这 些 类 可 以 被 映射 到 数据 库 的 某 个 数据 表 


中 ,使 用 时 从 数据 库 中 加 载 ,修改 后 用 于 更 新 数据 库 ; 也 可 以 在 代码 中 直接 使 用 这 些 类 , 直 


接 将 其 实例 传递 到 视图 中 。 


在 Razor 视图 文件 中 ,需要 先 用 @model 指定 声明 模型 对 象 的 数据 类 型 ,然后 在 视图 的 


任何 地 方 通过 Model 属性 来 引用 模型 实例 。 在 控制 器 类 中 ,有 两 种 方法 传递 模型 对 象 : 
中 通过 ViewData. Model 属性 来 传递 ; 四 调用 View 方法 时 将 模型 实例 赋值 给 方法 参数 。 
其 实 ,两 种 传递 模型 方法 的 本 质 是 相同 的 ,都 使 用 了 ViewData. Model 属性 。View 方法 的 
内 部 实现 是 先 将 模型 实例 赋值 给 ViewData. Model 属性 ,然后 在 创建 ViewResult 实例 时 ， 
将 Controller 类 ViewData 属性 的 引用 赋值 给 ViewResult 对 象 的 ViewData 属性 。 


本 实例 的 数据 模型 是 Student 类 , 先 在 控制 器 中 创建 一 个 用 于 测试 的 Student 对 象 列表 ， 


然后 把 这 个 列表 传递 给 视图 ,在 视图 中 可 以 使 用 HTML 元 素来 呈现 列表 中 的 数据 信息 。 


【操作 流程 】 
步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 
步骤 2: 定义 一 个 Student 类 ,作为 示例 的 数据 模型 。 


public class Student 

{ 
public Guid ID { get; set; } 
public string Name { get; set; } 
public int age { get; set; } 
public string Course { get; set; } 

} 


步骤 3: 定义 控制 器 。 


public class StudentController : Controller 
{ 
public ActionResult AllStudents() 
{ 
IList<Student> stus = new List< Student >(); 
stus. Add( new Student 
上 
ID = Guid. NewGuid(), 
Nane = "小 歼 "， 
Me = 21 
Course = "C+t+" 
D); 
stus. Add( new Student 
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ID = Guid. NewGuid(), 
Nane = "小 王 "， 

Age = 20, 

Course = "C" 


D); 
stus. Add( new Student 


{ 
ID = Guid. NewGuid(), 
Nane = "小 刘 "， 
Mgt = 3， 
Course = "HTML + CSS" 
D); 


ViewData. Model = stus; 
return View(); 
} 
在 返回 ViewResult 时 ,还 可 以 直接 通过 以 下 的 View 方法 来 传递 数据 模型 。 


public ActionResult R11Students() 
{ 


return View(stus); 


’ 


步骤 4: 在 项 目 中 新 建 Views 目录 ,然后 在 Views 目录 下 新 建 Student 于 目录 。 
步骤 5: 在 Student 目录 下 添加 视图 文件 AllStudents. cshtml。 
步骤 6: 需要 在 视图 文件 的 顶部 使 用 @model 指令 声明 模型 的 数据 类 型 ,本 实例 中 数据 


模型 的 类 型 为 IList < Student >。 


@using Demo 
@model IList < Student > 


步骤 7: 设计 HTML 文档 内 容 , 使 用 < table > 标签 来 显示 列表 中 Student 对 象 的 属性 值 。 


< html > 
<body> 
< style type = "text/css"> 
table { 
border— style: solid; 
border — color: blue; 
jorder — spaeing:20px :号 
} 
</style> 
@{ 
if (Model != null && Model.Count > 0) 


{ 
<table> 
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<caption>3 学 员 列 表 </caption> 


<thead> 
<tr> 
<th> 编 号 
<th> 姓 名 
<th> 年 龄 
<th> 学 习 课 程 
<tbody> 
@{ 
foreach (Student s in Model) 
{ 
<tr> 
<td>@s.ID 
<td>@s. Nane 
<td>@s. Age 
<td>@s. Course 
</tr> 
, 
} 
</tbody> 
</table> 
} 
else 
: 
<div> 无 学 员 信息 </div> 
} 
} 
</body> 
</htnl > 


注意 : 由 于 Razor 语法 可 以 与 HTML 元 素 混 编 ,比较 容易 出 错 ,因此 在 编写 视图 文档 时 要 
格外 小 心 ,尤其 是 开始 标签 与 结束 标签 之 间 的 匹配 。 


步骤 8: 运行 应 用 程序 。 
步骤 9: 在 浏览 器 地 址 栏 中 输入 http: //localhost: 11025/student/allstudents, 按 
Enter 键 确认 后 可 以 看 到 如 图 16-13 所 示 的 效果 。 


加 locahost 


€ 曲 后 | @ ecahostliozsshdenyatkud 癌 让 | 大 和 如 图 


学 员 列 表 
编号 姓名 


49a6alfa-8e04-46d9-9209-5c6a7c88401d 小柳 


2c84324c-cd6b-46a5-a35b-716488138abb 小 王 
33dc8a2d-6eb5-4893-908f-cc5d566d54f0 小 刘 


图 16-13 在 视图 中 呈现 数据 模型 
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实例 362 在 控制 器 中 接收 服务 列表 的 注 人 

【导语 】 

为 了 便于 扩展 和 维护 ,服务 类 型 有 时 使 用 “接口 -实现 类 ”的 方式 来 开发 ,因此 一 个 服务 
接口 可 能 会 按照 不 同 的 功能 有 多 个 实现 类 。 在 注册 服务 时 ,一 种 方案 是 以 接口 的 实现 类 作 
为 服务 类 型 ,分 别 添加 到 服务 容器 中 ,在 依赖 注 和 人 时, 分别 接受 各 个 实现 类 型 ; 另 一 种 方案 
是 以 共同 的 接口 作为 服务 类 型 ,把 多 个 实现 类 型 添加 到 服务 容器 中 ,在 依赖 注入 时 ,可 以 使 
用 IEnumerable< T > 来 单独 接收 服务 列表 。 

本 实例 将 演示 在 控制 器 的 构造 函数 中 接收 服务 类 型 列表 ,此 方案 适用 于 所 有 支持 依赖 
注入 的 方法 ,例如 Startup 类 的 Configure 方法 .中间 件 类 的 Invoke 方法 等 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 声明 一 个 接口 ,作为 各 个 服务 实现 类 的 共同 规范 。 


public interface ITestService 
{ 

string HashName { get; } 

string GetResult (string input); 
} 


步骤 3: 定义 两 个 类 ,都 实现 上 述 接口 ,一 个 使 用 MD5 哈 希 算法 进行 计算 , 另 一 个 使 用 
SHA256 哈 希 算法 进行 计算 , 详 见 代 码 清 单 16-2。 


代码 清单 16-2 ”两 个 服务 实现 类 


public class MD5CrtTest : ITestService 
{ 


public string HashName = > "MD5"; 


public string GetResult(string input) 
{ 
if (string. IsNullOrEmpty( input)) 
{ 
return null; 
} 
byte[ ] data = Encoding. UTF8.GetBytes( input); 
string result = null; 
using(MD5 md5 = MD5.Create()) 
byte[ ] output = md5.ComputeHash(data); 
result = Convert.ToBase64String(output); 
} 


return result; 
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Eublic class SHA256Test : ITestService 


{ 
public string HashName = > "SHA256"; 


public string GetResult(string input) 
长 
证 (string. IsNullOrEmpty(input)) 


return null; 
} 
byte[ ] contentbytes = Encoding.UTEF8.GetBytes(input); 
byte[ ] computedbytes = null; 
using(SHA256 sha256 = SHA256. Create()) 


{ 
computedbytes = sha256.ComputeHash(contentbytes); 


和 
return Convert. ToBase64String( computedbytes); 


步骤 4: 在 初始 化 应 用 程序 时 ,通过 WebHostBuilder 类 的 ConfigureServices 方法 注册 
服务 (也 可 以 在 Startup. ConfigureServices 方法 中 注册 ) 。 


new WebHostBuilder() 


.ConfigureServices(services => 


{ 
services. RddMvc() ; 
services. hddScoped < ITestSservice, MD5CrtTest >(); 
services. AddScoped < ITestService, SHA256Test >(); 
}) 
.Build() 
‘Run( ); 


步骤 5: 定义 Demo 控制 器 ,其 中 公开 Encode 方法 , 先 从 HTTP 请 求 的 查询 参数 中 读 
取 名 为 text 的 参数 值 ,再 用 注入 的 服务 类 实例 进行 哈 希 计算 ,最 后 以 JSON 格式 将 结果 返 
回 给 客户 端 。 


public class DemoController : Controller 


{ 


IEnumerable< ITestService> _encoders; 
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public DemoController( IEnumerable < ITestService> svs) 
{ 
_encoders = svs; 


[HttpGet] 
public JsonResult Encode( ) 
E 
// 获取 文本 
string q = Request. Query["text"]; 


IDictionary< string, string> dic = new Dictionary< string, string>(); 


dic["text"] = q; 
// 分 别 用 注入 的 服务 进行 哈 希 计算 
foreach( ITestService sv in _encoders) 
{ 
stringr = sv.GetResult(q); 
dic[ sv, HashName] = r; 


return Json(dic) 


村 


以 IEnumerable< ITestService > 类 型 作为 构造 函数 参数 的 类 型 可 以 接受 整个 类 型 列表 


的 依赖 注入 ,这 些 类 型 的 条 件 是 都 实现 了 ITestService 接口 。 

HttpGet 特性 描述 的 Encode 方法 接受 HTTP-GET 方式 的 请 求 , 并 且 返 
的 数据 ,此 方法 不 返回 视图 . 即 作 为 Web API 公开 . 

步骤 6: 运行 应 用 程序 ,并 用 以 下 URL 进行 测试 。 


http://localhost:6974/demo/encode?text = 我 是 客户 端 


JSON 格式 


text 参数 可 以 提交 用 于 哈 希 计算 的 文本 ,请求 后 Web 服务 将 回应 以 下 内 容 。 


{ 

"text" : "我 是 客户 端 "， 

"MD5" : "B4X1qSj7JZ0ZbrsZGYdFxw ==", 

"SHA256" : "B4x8EIu6E4T8Oh2kZ1k6 + NhL3Va6eg9J6my4unMmkp8 = " 
} 


实例 363 ”使 用 IFormCollection 组 件 来 提取 form 表单 数据 


【导语 】 


可 以 通过 < form > 元 素 收集 用 户 在 HTML 页 面 上 输入 的 内 容 ,提交 到 服务 器 后 , 转 由 
指定 控制 器 中 的 某 个 操作 方法 进行 处 理 。 操 作 方法 可 以 通过 参数 来 接收 所 提交 的 表单 


数据 。 


操作 方法 将 参数 声明 为 IFormCollection 类 型 ,HTML < form > 元 素 所 提交 的 内 容 会 存 
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放 在 IFormCollection 实例 中 ,然后 程序 代码 就 可 以 提取 实例 中 的 数据 ,其 结构 类 似 于 字典 
数据 类 型 ,通过 Key 可 以 检索 对 应 的 值 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 定义 控制 器 Demo ,其 中 有 两 个 操作 方法 。 


public class DemoController : Controller 
{ 
public ActionResult Default() => View(); 


public ActionResult PostUp(IFormCollection form) 
{ 


IDictionary< string, string> dic = new Dictionary< string, string>(); 
foreach( string k in form. Keys) 
{ 
stringv = form[k]; 
dic[k] = v; 
} 


return View("Show", dic); 


} 


PostUp 方法 在 客户 端 进行 提交 后 执行 ,从 form 参数 中 提取 出 数据 ,并 转 存 到 一 个 字典 
实例 中 ,最 后 再 把 字典 实例 传递 给 Show 视图 。 


注意 : IFormCollection 接口 的 默认 实现 类 是 FormCollection 类 ,但 是 在 声明 操作 方法 参数 
时 不 能 直接 使 用 FormCollection 作为 参数 类 型 ,而 要 使 用 IFormCollection 接口 。 


步骤 3: 以 下 是 Default 视图 的 代码 。 


<html > 
<body> 


<table> 
<tr> 
<td> 
< label for = "city"> 城 市 :</label > 
</td> 
<td> 
< input type = "text" name= "city" form= "form"/> 
</td> 
</tr> 
"> 
<td> 
< label for = "name"> 姓 名 :</label> 
</td> 
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<td> 
< input nane = "nane" type= "text" form= "form"/> 
</td> 
</tr> 
</table> 
< form id = "form" asp — controller = "Demo" asp — action = "PostUp"> 
< input type = "submit" value = "提交 "人 > 
</form> 
</body> 
</htnl > 


asp-controller 和 asp-action 是 标记 帮助 器 ,用 于 指定 处 理 该 < form > 元 素 所 提交 内 容 的 
控制 器 和 操作 方法 。 在 服务 器 上 执行 帮助 器 代码 后 会 自动 生成 提交 的 URL。 
步骤 4: Show 视图 用 于 显示 在 前 一 个 视图 中 输入 的 内 容 。 


@model IDictionary< string, string> 


<html> 
<body> 
<h3> 你 输入 的 内 容 </h3> 
@{ 


foreach(var i in Model) 


{ 
<p>@i.Key : @i.Value </p> 
} 
} 
</body> 
</htnl > 


@model 指令 用 于 声明 该 视图 接收 的 模型 对 象 为 字典 类 型 。 随 后 通过 Model 属性 即 可 
获取 字典 的 实例 引用 ,并 使 用 foreach 语句 枚 举 出 子 项 中 的 Key 与 Value 值 。 

步骤 5: 运行 应 用 程序 ,首先 进入 Default 视图 ,接收 用 户 的 输入 (如 图 16-14 所 示 ) 。 答 
入 完成 后 , 单 击 * 提 交 ?” 按 钮 , 转 到 Show 视图 ,显示 刚刚 输入 的 内 容 ( 如 图 16-15 所 示 ) 。 


上 ecaos x EX 
ee D localhostB574/Den 衣 

你 输入 的 内 容 

city : 成 都 


回 loalho x 


name : 小 张 
e oo © localhost8674/ 去 


_ RequestVerificationToken : 

| 城市: | 成 者 CfDJSOeZ5x9o2U5HrcwHCsEwJDGlwEzCSl 
姓名 : 号 人 
gdeu_3Vhx_kfBEcSg8805J02OmBqsYt9bVH 
| 


图 16-14 输入 相关 内 容 图 16-15 显示 输入 的 内 容 
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实例 364 在 Web API 中 直接 提取 上 传 的 文件 


【导语 】 

Web API 通常 不 使 用 视图 ,如 果 调 用 客户 端 是 直接 向 服务 器 发 送 文件 内 容 , 而 不 是 通 
过 HTML < form > 方式 提交 ,那么 Action 方法 使 用 IFormFile 类 型 的 参数 是 无 法 接收 到 数 
据 的 。 一 个 非常 简单 的 解决 方法 就 是 直接 从 HttpContext 对 象 中 读 取 请 求 正文 ,并 且 这 种 
方法 也 不 用 考虑 content-type, 正 文 都 是 二 进 制 数 据 , 以 流 的 形式 读 入 。 

本 实例 将 演示 一 个 允许 客户 端 直接 上 传 文件 的 Web API, 并 使 用 HTTP 头 来 提供 文 
件 名 。 

【操作 流程 】 

该 实例 包含 两 个 项 目 , 除 了 主要 的 ASP. NET Core 应 用 项 目 ,还 包括 一 个 控制 台 应 用 
项 目 , 用 于 测试 Web API 的 调用 。 

首先 是 ASP. NET Core 项 目的 实现 部 分 。 

步骤 1: 定义 Demo 控制 器 ,包含 UploadFile 方法 。 


public class DemoController : Controller 
{ 
[HttpPost] 
public ActionResult UploadFile( ) 
{ 
Var request = HttpContext. Request; 
Stream Stream = request. Body; 
byte[ ] data = null; 
// 读 取 正 文 内 容 
using(MemoryStream ms = new MemoryStream()) 
* 
stream. CopyTo(ms); 
data = ms.ToArray(); 


// 提取 文件 名 

string fileName = request.Headers["file- name"]; 

// 返回 状态 码 200 

return 0k( $ "已 成 功 上 传 文件 {fileName??" 未 知 "}, 大 小 为 {data. Length} 字 节 "); 


} 
由 于 此 处 仅 做 演示 ,并 没有 保存 接收 到 的 文件 内 容 , 所 以 只 向 调用 方 返回 一 条 上 传 成 功 
的 应 答 消 息 。HttpRequest. Body 属性 就 是 HTTP 请 求 的 正文 内 容 ,以 流 的 形式 公开 ,并 且 是 
只 读 的 。 上 述 代码 中 , 先 将 数据 复制 到 内 存 流 中 ,再 转换 为 字 节 数组 。 由 于 HttpRequest. Body 
属性 所 公开 的 流 对 象 并 没有 实现 Length 属性 ,如 果 直 接 获 取 , 其 长 度 会 发 生 异 常 ,所 以 要 先 
把 内 容 复制 到 内 存 流 中 ,以 方便 处 理 。 
步骤 2: 一 般 来 说 ,文件 的 内 容 是 比较 大 的 ,有 可 能 超出 Kestrel 服务 器 的 默认 大 小 限 
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制 。 为 了 避免 文件 上 传 失败 ,需要 修改 对 正文 大 小 的 限制 。 在 应 用 程序 的 Program 类 中 找 
到 项 目 模板 默认 生成 的 CreateWebHostBuilder 方法 ,对 它 做 如 下 修改 。 


public static IWebHostBuilder CreateWebHostBuilder( string[ ] args) => 
WebHost. CreateDefaultBuilder(args) 
.UseStartup < Startup >() 
.UseKestrel(o=> 
{ 
0.Limits. MaxRequestBodySize = 5000000000; 


D; 
MaxRequestBodySize 属性 限制 的 是 请 求 正文 的 最 大 长 度 , 一 般 只 需要 修改 这 一 选项 。 
接 下 来 实现 一 个 测试 的 客户 端 项 目 。 
步骤 3: 声明 一 些 稍 后 要 使 用 到 的 变量 。 


// 请 求 URL 

string url = "http://localhost:5000/demo/uploadfile"; 
// 测试 文件 名 

string FileName = "sample. dat"; 

// 产生 字 节 数 


int byteCount = 8000; 


以 变量 形式 存储 这 些 值 ,在 测试 代码 时 便于 修改 ,例如 文件 名 和 文件 大 小 。 本 实例 中 没 
有 使 用 真实 的 文件 ,而 是 生成 随机 字 节 来 模拟 文件 内 容 。 

步骤 4: 生成 随机 字 节 , 稍 后 用 于 提交 到 Web 服务 器 。 

byte[ ] bytes = new byte[byteCount]; 


Random rand = new Random(); 
rand. NextBytes(bytes); 


步骤 5: 向 服务 器 发 起 请 求 ,并 接收 响应 消息 。 


using(HttpClient client = new HttpClient()) 
{ 


// 设置 HTTP 头 

client. DefaultRequestHeaders. Mdd("file— name", FileName); 
// 创建 正文 内 容 

ByteArrayContent content = new ByteArrayContent(bytes); 
// 发 起 请 求 

Console. WriteLine(" 正 在 发 送 数 据 ,请 稍 候 …… "); 


HttpResponseMessage response = await client.PostAsync(url, content); 
string respnsg = await response.Content.ReadMsStringAsync(); 
Console. WriteLine( $ "服务 器 返回 消息 :\n{respmsg}"); 
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步骤 6: 运行 应 用 程序 ,结果 如 图 16-16 所 示 。 


图 16-16 直接 发 送 文件 内 容 


实例 365 用 部 分 视图 来 显示 当前 日 期 

【导语 】 

本 实例 旨 在 演示 部 分 视图 的 用 法 , 仅 使 用 部 分 视图 来 显示 日 期 。 

部 分 视图 与 普通 视图 没有 太 大 区 别 , 它 可 以 将 一 些 重 复 使 用 的 HTML 内 容 组 合 起 来 ， 
可 以 单独 使 用 。 假 如 一 个 站 点 中 ,每 个 页 面 都 要 显示 登录 信息 ,如 果 用 户 已 登录 就 显示 登录 
的 用 户 信息 ; 如 果 没 有 登录 ,就 显示 用 户 名 和 密码 输入 框 以 便 用 户 进行 登录 操作 。 这 个 显 
示 登 录 信息 的 内 容 就 可 以 做 成 部 分 视图 ,并 在 多 个 视图 中 引用 。 

部 分 视图 不 应 该 公开 被 客户 端 访 问 ,所 以 一 般 命 名 的 时 候 会 在 视图 名 称 前 加 下 画 线 , 例 
如 _Login. cshtml、RegCounter. cshtml 等 。 部 分 视图 可 以 放 在 /Views/Shared 目录 下 或 者 
与 当前 控制 器 同名 的 目录 下 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 创建 Test 控制 器 ,公开 Default 操作 方法 。 


[Route("[controller]/[action]")] 
public class TestController : Controller 


{ 
public IActionResult Default() 


{ 


return View(); 
} 
i 


步骤 3: 在 项 目下 新 建 Views 目录 ,并 在 Views 目录 下 新 建 Shared 目录 。 
步骤 4: 在 Shared 目录 下 添加 一 个 部 分 视图 ,命名 为 showDate. cshtml。 


< div style = "padding:25px 20px;border:2px solid yellow; background ~ color: lightgoldenrodyellow"> 
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@DateTime. Today. ToString("yyyy' 年 'M' 月 'd' 日 ', dddd") 
</div> 


步骤 5: 在 Views 目录 下 新 建 与 Test 控制 器 同名 的 目录 。 
步骤 6: 在 Test 目录 下 添加 Default. cshtml 视图 。 


<html> 
<body> 
<div> 
< h4 > 示例 程序 </h4 > 
</div> 
<div> 
@await Html. PartialAsync("_showDate") 
</div> 
</body> 
</htnl > 


如 果 要 引用 部 分 视图 ,可 以 调用 PartialAsync 方法 并 指定 要 引用 的 视图 的 名 称 。 与 普 
通 视图 一 样 ,对 于 可 以 被 查找 到 的 部 分 视图 ,不 需要 指定 路 径 和 扩展 名 。 

不 仅 可 以 调用 PartialAsynec 方法 ,还 可 以 使 用 标记 帮助 器 来 引用 部 分 视图 。 首 先 使 用 
@addTagHelper 指令 导入 标记 帮助 器 的 类 型 。 

@addTagHelper * ,Microsoft.AspNetCore.Mvc.TagHelpers 


然后 使 用 < partial > 元 素来 指定 所 引用 的 部 分 视图 。 


四 localhost x 
<div> 0 @ localhost60400/te 让 
< partial name = "_showDate"/> 示例 程序 
</div> 
两 种 引用 部 分 视图 的 方法 , 任 选 其 一 即 可 。 2018 年 10 月 11 日 ， 星 期 四 


步骤 7: 运行 应 用 程序 ,访问 地 址 http: //< 测 试 域 
名 >/test/default, 就 可 以 看 到 如 图 16-17 所 示 的 效果 。 


实例 366 ”使 用 视图 组 件 


【导语 】 

视图 组 件 (View Component) 与 部 分 视图 在 功能 上 比较 相似 ,但 视图 组 件 比 部 分 视图 更 
灵活 。 与 控制 器 相似 ,视图 组 件 可 以 实现 视图 与 代码 分 离 ,并 且 一 个 视图 组 件 可 以 返回 多 个 
视图 。 

视图 组 件 有 两 种 实现 方法 : 

(1) 直接 从 ViewComponent 类 派生 ,并 包括 Invoke 或 InvokeAsync 方法 。 

(2) 自 定义 类 ,需要 在 类 上 应 用 ViewComponent 特性 (ViewComponentAttribute 类 )， 
并 包含 Invoke 或 InvokeAsync 方法 。 


图 16-17 显示 日 期 的 部 分 视图 


第 16 章 MVC 与 Web AP| | 493 


Invoke 或 InvokeAsync 方 法 是 约定 方法 ,允许 定义 方法 参数 ,返回 值 类 型 需要 实现 
IViewComponentResult 接口 。 框 架 默 认 实 现 了 两 个 类 型 一 ViewViewComponentResult 
与 ContentViewComponentResult。 对 于 Razor 文档 ,在 需要 呈现 视图 组 件 的 地 方 调用 
Component. InvokeAsync 方法 。 

视图 组 件 会 在 以 下 路 径 中 查找 视图 : 

(1) 共享 组 件 : 默认 位 于 /Views/Shared/Components/< 视 图 组 件 名 称 >/< 视 图 > 
. cshtml。 共 享 的 视图 组 件 可 以 在 应 用 项 目 范围 内 访问 。 

(2) 非 共享 组 件 : 默认 位 于 /Views/< 控 制 器 名 称 >/Components/< 视 图 组 件 名 称 >/< 视 图 > 
.cshtml。 非 共享 组 件 只 可 以 在 当前 控制 器 中 访问 。 

【操作 流程 】 

步骤 1: 新建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 定义 视图 组 件 类 ,命名 为 Test。 


public class TestViewComponent : ViewComponent 
{ 
IHostingEnvironment m env = null; 
public TestViewComponent( IHostingEnvironment env) 
{ 
m env = env; 
} 
public IViewComponentResult Invoke() 
{ 
return View("_showInfo", m env); 
} 
} 


视图 组 件 的 名 称 可 以 带 “ViewComponent” 后 级 ,这 是 可 选 的 。 视 图 组 件 必须 包含 
Invoke 或 者 InvokeAsync 方法。 在 以 上 代码 中 ,方法 返回 _showInfo 视图 ,并 日 将 通过 依赖 
注入 获取 到 的 IHostingEnvironment 实例 作为 Model 传递 给 视图 。 
步骤 3: 定义 Demo 控制 器 ,并 返回 Start 视图 。 
public class DemoController : Controller 
{ 
public ActionResult Start() 
{ 
return View(); 
i 
} 


步骤 4: 在 项 目 中 新 建 Views 目录 。 
步骤 5: 在 Views 目录 下 新 建 Shared 目录 ,再 在 Shared 目录 下 新 建 Components 目 
录 , 用 于 放置 视图 组 件 相关 的 视图 。 
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步骤 6: 在 Components 目录 下 新 建 一 个 与 Test 视图 组 件 同名 的 目录 。 
步骤 7: 在 Test 目录 下 添加 视图 文件 _showInfo. cshtml。 


@model Microsoft. AspNetCore. Hosting. IHostingEnvironment 


< div style = "color:red;font - size:18px"> 
关 生 > 
应 用 程序 名 称 :@Model. ApplicationName 
</p> 
<p> 
当前 运行 环境 :@Model. EnvironmentName 
</p> 
</div> 


@model 指令 用 于 声明 Model 属性 返回 的 类 型 (从 视图 组 件 代码 传递 进来 的 模型 对 象 ) 。 
步骤 8: 在 Views 目录 下 新 建 一 个 与 Demo 控制 器 同名 的 目录 。 
步骤 9: 在 Demo 目录 下 添加 Start. cshtml 视图 文件 。 


< html > 
<body> 


<div> 
<hl > 应 用 主页 </hl > 
</div> 
<hr/> 
<div> 
<h3 > 以 下 为 视图 组 件 :</h3 > 
@await Component. InvokeAsync( "Test") 
</div> 
</body> 
</htnl > 


Component. InvokeAsync 方法 有 两 种 方式 指定 要 使 用 的 视图 组 件 : 四 直接 以 字符 串 形 
式 给 出 视图 组 件 的 名 称 ; @ 直 接 引 用 视图 组 件 类 的 Type 对 象 ,可 以 用 typeof 运算 符 来 获 
取 , 格 式 如 下 。 


@await “Conponent. Invokehsync(typeof(TestViewConponent) ) 


调用 Component. InvokeAsync 方法 的 代码 需要 以 单行 代码 的 方式 混 写 在 HTML 代码 
为 访问 视图 组 件 后 会 返回 一 段 HTML 内 容 并 呈现 到 主 视图 上 , 即 不 能 在 代码 块 中 调 


中 


半 


， 


用 方法 ,那样 会 导致 返回 的 HTML 内 容 无 法 呈现 。 
以 下 代码 不 可 取 
@{ 


await Component. InvokeAsync ("Test"); 
} 
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步骤 10: 运行 应 用 程序 ,在 浏览 器 地 址 栏 中 输入 http: //< 测 试 域名 >/ demo/start, 就 
能 看 到 如 图 16-18 所 示 的 效果 。 


ee 


人 口 © localhosts 让 | 时 |… 


应 用 主页 


以 下 为 视图 组 件 : 
应 用 程序 名 称 : Demo 


当前 运行 环境 : Development 


图 16-18 使 用 视图 组 件 显示 应 用 程序 的 环境 信息 


实例 367 在 视图 中 接收 依赖 注入 


【导语 】 
在 视图 文件 中 ,使 用 @inject 指令 可 以 接收 来 自 依赖 注入 的 对 象 实例 ,格式 如 下 。 


@inject < 类 型 > < 变量 名 > 

为 了 让 代码 能 够 访问 注入 的 对 象 ,应 当 为 其 分 配 一 个 局 部 变量 名 ,分 配 格式 如 下 。 

@ inject ILooger logger 

本 实例 将 演示 从 视图 中 接收 IHostingEnvironment 对 象 的 注入 ,然后 在 页 面 上 显示 应 
用 程序 的 名 称 .运行 环境 和 程序 内 容 的 根 目录 。 

【操作 流程 】 

步骤 1: 新建 空白 的 ASP. NET Web 应 用 程序 项 目 。 

步骤 2: 在 Startup 类 中 配置 与 MVC 框架 相关 的 服务 与 中 间 件 。 


public void ConfigureServices( IServiceCollection services) 
{ 
services. AddMvc( ); 


} 


public void Configure( IApplicationBuilder app) 
{ 
app. UseMvc(); 


} 


步骤 3: 在 项 目 目 录 下 新 建 Pages 目录 。 
步骤 4: 在 Pages 目录 下 添加 Razor 页 面 ,命名 为 Default. cshtml。 
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步骤 5: 在 页 面 文档 的 首 行 添加 相关 指令 ,用 @inject 指令 接收 IHostingEnvironment 


类 型 的 注入 。 


@page "/ 
@inject Microsoft.AspNetCore.Hosting. IHostingEnvironment envhost 


步骤 6: 页 面 的 HTML 代码 如 下 。 


<div> 

当前 应 用 程序 :@envhost. ApplicationName 
</div> 
<div> 

运行 环境 :@envhost. EnvironmentNane 
</div> 
<div> 

应 用 根 目录 :@envhost. ContentRootPath 
</div> 


步骤 7: 运行 应 用 程序 ,结果 如 图 16-19 所 示 。 
EE | 
所 > 口 合 © localhosb54927/ 区 | 9 
当前 应 用 程序 : Demo 


| 运行 环境 : Development 
| 应 用 根 目录 : Ci\Users\hlimmisource\repos\Demo\Demo 


图 16-19 显示 当前 运行 环境 的 信息 


16.3 静态 文件 与 目录 浏览 


实例 368 ”访问 静态 文件 
【导语 】 


静态 文件 是 相对 于 可 在 服务 器 上 执行 的 文件 (例如 Razor 视图 ) 而 言 的 ,常见 的 静态 文 


件 有 CSS 样式 表 、JavaScript 脚本 、 多 媒体 文件 .HTML 静态 页 面 等 。 


ASP. NET Core 应 用 程序 默认 是 不 启用 对 静态 文件 访问 的 ,如 果 启 用 对 静态 文件 的 访 


问 , 需 要 在 Startup. Configure 方法 中 调用 UseStaticFiles 方法 。 


静态 文件 在 默认 情况 下 位 于 项 目的 /wwwroot 目录 下 , 若 要 更 改 静态 文件 位 置 , 可 以 使 


用 StaticFileOptions 类 来 进行 配置 。 
本 实例 演示 了 如 何 设置 静 态 文 件 选项 ,使 得 视图 页 面 能 够 访问 位 了 
extLibs/js 目录 下 的 JQuery 脚本 。 由 于 相对 路 径 比 较 宛 长 ,本 实例 将 设置 一 个 简短 的 请 求 
路 径 /is, 即 通过 http: //localhost/js/jquery. js 就 能 访问 脚本 文件 了 。 


Fwwwroot/ 


第 16 章 MVC 与 Web AP| | 497 


【操作 流程 】 
步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 
步骤 2: 在 Startup. ConfigureServices 方法 中 注册 MVC 功能 服务 。 


public void ConfigureServices(IServiceCollection services) 


{ 


services. AddMvc( ); 


} 


步骤 3: 对 于 Startup. Configure 方法 ,在 调用 UseMvc 方法 之 前 ,需要 先 调用 
UseStaticFiles 方法 对 静态 文件 参数 进行 配置 。 


public void Configure( IApplicationBuilder app, IHostingEnvironment env) 
{ 


StaticFileOptions sfoption = new StaticFileOptions 


{ 
FileProvider = new PhysicalFileProvider (Path. Combine(env. WebRootPath, "extLibs/ 


js")), 
RequestPath = "/js" 
}; 
app. UseStaticFiles(sfoption); 
app. UseMvc( ); 
} 


人 允许 访问 的 静态 文件 所 在 的 目录 为 /wwwroot/extLibs/js, 映 射 后 的 相对 URL 为 /js。 
之 所 以 先 于 UseMvc 方法 调用 UseStaticFiles 方法 ,是 为 了 优先 处 理 对 静态 文件 的 请 求 ,如 
果 客 户 端 访问 的 不 是 静态 文件 , 青 转 到 MVC 框架 进行 处 理 。 

步骤 4: 在 项 目 所 在 的 目录 下 新 建 一 个 Pages 目录 ,并 在 Pages 目录 中 添加 一 个 Razor 
页 面 ,命名 为 Index. cshtml。 


@page "~/" 
<! DOCTYPE htm] > 
<html> 


</htnl > 
步骤 5: 在 header 元 素 中 引用 jquery. js 脚本 。 


< script type = "text/javascript" src = "/js/jquery. js"></script> 


注意 : 访问 脚本 所 使 用 的 路 径 , 应 该 是 /js 路 径 下 的 文件 ,因为 在 配置 静态 文件 时 已 进行 了 
映射 。 
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步骤 6: 在 body 元 素 中 编写 正式 内 容 , 让 div 元 素 产生 向 右 移 动 的 动画 。 


<div> 
< button id = "btnstart"> 向 右 移动 </button> 
<button id = "btnreset"> 重 置 </button > 
</div> 
<div> 
<div id= "rect"/> 
</div> 


< script type = "text/javascript"> 

$ ("#btnstart").click(() =>{ 

$ ("#rect").animate({ 
left: 150 

}, 600); 

DD); 

$ ("#btnreset").click(() =>{ 
$("#rect").css("left", 0); 

D); 


</script> 

步骤 7: 运行 应 用 程序 ,效果 如 图 16-20 所 示 。 图 16-20 矩形 向 右 移动 
实例 369 ”开启 日 录 浏 览 功 能 

【导语 】 


目录 浏览 功能 允许 客户 端 查看 某 个 Web 目录 下 的 子 目录 和 文件 列表 ,可 以 直接 查看 或 
下 载 文件 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 项 目 模板 生成 的 wwwroot 目录 下 创建 一 个 子 目 录 ,命名 为 images。 

步骤 3: 在 images 目录 下 放 管 五 个 . g 计 文件 (任意 文件 都 可 以 , 仅 用 于 测试 ) 。 

步骤 4: 在 Startup. ConfigureServices 方法 中 调用 AddDirectoryBrowser 方法 注册 相 


关 服 务 ( 此 方法 内 部 实质 上 是 调用 了 AddWebEncoders 方法 )。 


public void ConfigureServices( IServiceCollection services) 
{ 
services. AddDirectoryBrowser( ); 


3 
步骤 5: 在 Startup. Configure 方法 中 ,依次 调用 UseDirectoryBrowser 方法 和 


UseStaticFiles 方法 ,两 个 方法 的 调用 顺序 可 以 互 换 。 


public void Configure( IApplicationBuilder app，IHostingEnvironment env) 
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if (env. IsDevelopment()) 
{ 
app, UseDeveloperExceptionPage( ); 


app.UseStaticFiles(new StaticFileOptions 


FileProvider = new PhysicalFileProvider(Path. Combine(env. WebRootPath， "images" ) )， 
RequestPath = "/gifs" 


app. UseDirectoryBrowser( new DirectoryBrowserOptions 


FileProvider = new PhysicalFileProvider(Path. Combine(env. WebRootPath, "images")), 
RequestPath = "/gifs" 
DD); 


app. Run(async (context) => 
{ 
await context. Response. WriteAsync("Hello World! "); 


D); 


注意 : UseStaticFiles 方法 和 UseDirectoryBrowser 方法 的 参数 设置 相同 ,但 是 
UseStaticFiles 方法 必须 调用 ,否则 客户 端 只 能 浏览 目录 而 不 能 下 载 文件 。 如 果 既 
需要 浏览 目录 又 要 访问 静态 文件 ,比较 好 的 替代 方案 是 调用 UseFileServer 方法 。 


步骤 6: 运行 应 用 程序 ,访问 http: / /< 测试 域名 >/gifs 可 以 看 到 images 目录 下 的 文件 
(本 实例 只 允许 查看 images 目录 下 的 内 容 ) ,如 图 16-21 所 示 。 


index of Jgifs/ x 
4 >》 曲 向 | O localhos57 


Index of /gifs/ 


Name Size Last Modified 
anm-1.gif 1.827,158 2018-10-162:18:35 +00:00 
anm-2.gif 672,123 2018-10-16 2:18:56 +00:00 
anm-3,gif 29,310 ”2018-10-16 2:19:45 +00:00 
anm-4.gif 10,923 ”2018-10-16 2:20:08 +00:00 
anm-5.gif 24,136 2018-10-16 2:20:35 +00:00 


女 | 鸭 | 因 太公 


图 16-21 列 出 images 目录 下 的 文件 
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实例 370 “文件 服务 


【导语 】 
当 应 用 项 目 既 需要 浏览 目录 结构 ,又 需要 访问 静态 文件 时 ,可 以 考虑 使 用 文件 服务 
功能 。 


UseFileServer 方 法 综合 了 UseStaticFiles 方法 和 UseDirectoryBrowser 方法 的 功能 ， 
参数 可 以 通过 FileServerOptions 类 来 设置 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 项 目 模板 生成 的 wwwroot 目录 下 新 建 六 个 文本 文件 ,并 向 每 个 文件 中 随意 
输入 一 些 内 容 , 这 些 文件 仅 用 于 稍 后 测试 。 

步骤 3: 在 Startup. ConfigureServices 方法 中 调用 AddDirectoryBrowser 方法 。 


public void ConfigureServices(IServiceCollection services) 
{ 


services. AddDirectoryBrowser(); 


} 
步骤 4: 在 Startup. Configure 方法 中 调用 UseFileServer 方法 ,并 配置 好 相关 选项 。 


public void Configure( IApplicationBuilder app, IHostingEnvironment env) 
{ 
if (env. IsDevelopment()) 
让 
app. UseDeveloperExceptionPage( ) ; 
} 


app. UseFileServer (new FileServerOptions 

{ 
FileProvider = new PhysicalFileProvider(env. WebRootPath), 
RequestPath = "/files", 
EnableDirectoryBrowsing = true 

D); 


app. Run(async (context) => 
{ 

await context. Response. WriteAsync( "Hello World! "); 
D); 


注意 : 将 EnableDirectoryBrowsing 属性 设置 为 true 才 会 提供 浏览 目录 的 服务 ,如 果 不 设置 
该 属性 ,就 相当 于 提供 静态 文件 服务 ,不 能 浏览 目录 结构 。 


步骤 5: 运行 
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应 用 程序 ,效果 如 图 16-22 所 示 。 
国 辐 = Index of /files/ x 


Name 
file 1.txt 
file 2.txt 
file 3.txt 
file 4.txt 
file 5.txt 
file 6.txt 


Size 
10 
10 
10 
10 
10 
10 


和 > DO 全 © localhost51883/files/ 廊 芭 | 大 下 


Index of /files/ 


Last Modified 
2018-10-16 3:49:03 +00:00 
2018-10-16 3:49:21 +00:00 
2018-10-16 3:49:37 +00:00 
2018-10-16 3:49:59 +00:00 
2018-10-16 3:50:17 +00:00 
2018-10-16 3:50:34 +00:00 


16-22 列 出 六 个 文本 文件 


应 用 配置 与 数据 库 访 问 


在 本 章节 中 ,读者 将 学 习 到 以 下 内 容 : 
， 配置 应 用 程序 ; 

。 选项 类 ， 

。 EF Core( 实 体 框架 )。 


17.1 配置 应 用 程序 


实例 371 自 定义 环境 变量 的 命名 前 缀 

【导语 】 

用 于 对 应 用 程序 进行 配置 的 环境 变量 的 默认 前 级 为 “ASPNETCORE_”, 例 如 ,配置 应 
用 启动 URL 的 环境 变量 名 为 “ASPNETCORE_URLS”, 配置 运行 环境 的 环境 变量 名 为 
“ASPNETCORE_ENVIRONMENT”, 

但 有 时 不 希望 使 用 默认 的 环境 变量 前 缀 ,本 实例 将 演示 自 定义 环境 变量 命名 前 缀 的 
方法 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Main 方法 中 使 用 ConfigurationBuilder 类 添加 环境 变量 配置 源 。 

var configBuilder = new ConfigurationBuilder() 

.RddEnvironmentVariables("RPP_"); 

调用 带 prefix 参数 的 AddEnvironmentVariables 重 载 方法 ,prefix 参数 为 字符 串 类 型 ， 
用 来 指定 环境 变量 的 命名 前 级 。 本 实例 指定 的 前 缀 为 “APP_”, 即 所 有 有 效 的 环境 变量 名 都 
必须 以 此 前 级 开头 ,例如 "APP_URLS”。 

步骤 3: 使 用 上 面 的 配置 数据 来 配置 WebHostBuilder。 


var hostBuilder = new WebHostBuilder() 
.UseKestrel() 
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.UseContentRoot(Directory. GetCurrentDirectory()) 
.UseConfiguration(configBuilder.Build()) 
.UseStartup< Startup >(); 
hostBuilder. Build().Run(); 
ConfigurationBuilder 实例 需要 调用 Build 方法 生成 配置 信息 ,再 通过 WebHostBuilder 
实例 的 UseConfiguration 扩展 方法 应 用 配置 。 
步骤 4: 在 "解决 方案 资源 管理 器 ”窗口 中 右 击 项 目 名 称 ,从 快捷 菜单 中 选择 “属性 ” 命 
令 , 打 开 * 项 目 属性 ?窗口 。 
步骤 5: 切换 到 “调试 ?选项 卡 , 在 环境 变量 结 点 处 添加 两 个 环境 变量 ,如 图 17-1 所 示 。 


环境 变量 : 名 称 
AFP TELS 添加 
apP_ENVIRONENT |Developasnt 


图 17-1 配置 环境 变量 


注意 : 此 处 环境 变量 的 前 缓 已 变 为 “APP ”。APP_URLS 配置 应 用 程序 的 启动 URL， 
APP_ENVIRONMENT 配置 应 用 程序 的 运行 环境 。 


步骤 6: 保存 设置 并 关闭 * 项 目 属性 ?窗口 。 
步骤 7: 创建 一 个 简单 的 Demo 控制 器 , 稍 后 用 来 测试 应 用 程序 。 


[Route("/deno/[action]")] 
public class DemoController : Controller 


{ 
public IActionResult Index() 


E 


return View(); 
} 
} 
步骤 8: 在 项 目 中 创建 Views 目录 ,在 Views 目录 下 创建 Demo 子 目录 。 
步骤 9: 添加 Index 视图 ,HTML 代码 如 下 。 
<hl > 测试 网 站 </hl > 
<h4 > 欢迎 来 到 主页 。</h4 > 
步骤 10: 运行 应 用 程序 ,在 浏览 器 地 址 栏 中 输入 http: //localhost: 12130/demo/ 
index, 如 果 视 图 正常 显示 ,表明 环境 变量 配置 无 误 。 
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实例 372 ”使 用 JSON 文件 进行 配置 


【导语 】 

使 用 JSON 文件 配置 应 用 程序 ,修改 起 来 方便 ,不 用 重新 编译 应 用 程序 ,而 且 可 以 移植 
到 其 他 应 用 程序 中 使 用 。 

ConfigurationBuilder 在 生成 配置 数据 之 前 ,可 以 添加 多 个 配置 来 源 , 如 命令 行 参 数 、 环 
境 变量 JSON 文件 ,内存 中 的 宇 典 数 据 等 。 其 中 ,调用 AddJsonFile 扩展 方法 可 以 添加 来 自 
JSON 文件 中 的 配置 数据 ,AddJsonFile 方法 可 以 多 次 调用 ,以 便 添 加 来 自 多 个 JSON 文件 
的 数据 。 一 般 来 说 ,用 于 配置 的 JSON 文件 都 会 放 在 与 应 用 程序 相同 的 目录 下 ,此 时 可 以 调 
用 SetBasePath 扩展 方法 设 定 一 个 基础 路 径 ,以 后 调用 AddJsonFile 方法 时 只 需要 指定 文件 
的 相对 路 径 ( 相 对 于 SetBasePath 方法 所 指定 的 路 径 ) 。 

如 果 同 一 个 配置 项 在 多 个 配置 源 中 重复 出 现 ,那么 后 面 添加 的 值 会 覆盖 前 面 的 值 。 例 
如 ,urls 用 于 设置 Web 服务 器 运行 时 接收 请 求 的 地 址 ,假设 它 被 设置 了 两 次 ,第 一 次 设置 为 
http: //localhost: 900, 第 二 次 设置 为 http: //localhost: 1600 ,那么 应 用 程序 启动 时 会 选 
择 http: //localhost: 1600 作为 监听 URL。 

如 果 应 用 程序 在 Main 入 口 点 处 调用 了 WebHost. CreateDefaultBuilder 方法 ,那么 默 
认 情 况 下 会 使 用 名 为 appsettings. json 的 JSON 文件 进行 配置 。 

【操作 流程 】 

步骤 1: 新建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 项 目 中 添加 一 个 控制 器 ,名 为 Demo。 


public class DemoController : Controller 
{ 
RE 
{ 
return View(); 
} 
} 


步骤 3: 在 项 目 目录 下 新 建 Views 目录 ,再 在 Views 目录 下 新 建 Demo 子 目录 。 
步骤 4: 添加 Index 视图 。 


@ inject Microsoft. AspNetCore. Hosting. IHostingEnvironment env 
<div> 
<h4> 
应 用 程序 名 称 :@env. ApplicationName 
</h4> 
<h4> 
运行 环境 :@env.EnvironmentNane 
</h4> 
</div> 
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步骤 5: 在 项 目 中 添加 一 个 JSON 文件 ,命名 为 hosting. json。 
{ 


"applicationName" : "Demo", 
"urls": "http://localhost:22800", 
"environment": "Debugging" 


} 
步骤 6: 在 Main 入 口 点 中 ,将 上 面 的 hosting. json 文件 添加 到 配置 源 中 。 


IConfigurationBuilder cfgbd = new ConfigurationBuilder() 
.SetBasePath(Directory, GetCurrentDirectory( )) 
.AddJsonFile( "hosting. json"); 


步骤 7: 创建 WebHost 实例 的 相关 设置 。 


var hostbd = new WebHostBuilder() 
.UseKestrel() 
.UseContentRoot(Directory. GetCurrentDirectory( )) 
.ConfigureServices(svs => 
{ 
svs, AddMvc( ); 
}) 
.Configure(app => 
{ 
app. UseMvc (route => 


{ 


route. MapRoute( "default", 


ne Td < © Rl 四 支 
和 D; 应 用 程序 名 称 : Demo 
.UseConfiguration(cfgbd. Build() ); 运行 环境 : Debugging 

步骤 8: 启动 WebHost 实例 。 

hostbd. Build(). Run(); 图 17-2 显示 应 用 名 称 与 运行 环境 名 称 


步骤 9: 运行 应 用 程序 ,结果 如 图 17-2 所 示 。 

实例 373” 自 定义 命令 行 参数 映射 

【导语 】 

ASP. NET Core 应 用 程序 支持 通过 传递 命令 行 参数 来 配置 应 用 程序 ,这 些 命令 行 参 数 
追加 到 dotnet run 或 dotnet < 应 用 程序 . dl > 之 后 。 例 如 ,编译 应 用 程序 后 生成 的 文件 为 
LeetAPI. dll, 下面 三 种 方式 都 可 以 使 用 命令 行 参 数 来 配置 应 用 程序 的 监听 URL。 
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dotnet LeetAPI. dll urls= http://localhost:6570 

dotnet LeetRPI. dl1 - urls http://localhost:6570 

dotnet LeetAPI. dll /urls http://localhost:6570 

默认 情况 下 ,命令 行 参数 的 名 称 与 配置 项 的 名 称 相 同 ,但 是 也 可 以 在 命令 行 参数 和 配置 
项 之 间 创 建 一 个 映射 关系 ,使 命令 行 参数 的 名 称 与 配置 项 的 名 称 不 同 。 例 如 ,将 应 用 程序 运 
行 环境 的 配置 项 命名 为 environment, 这 个 名 字 太 长 ,可 以 使 用 命令 行 参数 。 或 者 env 来 指 
向 environment 配置 项 。 命 令 行 参 数 的 映射 列表 是 一 个 字典 对 象 ,其 中 ,Key 表示 命令 行 参 
数 的 名 称 ,Value 表示 配置 项 的 名 称 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Main 人 口 点 中 ,声明 一 个 字典 类 型 的 变量 ,对 命令 行 参数 进行 映射 。 


IDictionary< string, string> mapping = new Dictionary< string, string> 
{ 

Ee 

["--env"] = "environment" 


}; 

经 过 映射 后 ,设置 应 用 程序 监听 URL 的 命令 行 参数 为 -u, 设 置 运行 环境 的 命令 行 参数 
为 -env。 

步骤 3: 创建 ConfigurationBuilder 实例 ,并 添加 命令 行 参数 作为 配置 来 源 。 


IConfigurationBuilder configbd = new ConfigurationBuilder() 
. AddComnandLine(args, napping); 
步骤 4: 将 配置 信息 应 用 到 Host 上 。 


var hostbd = new WebHostBuilder() 
.UseConfiguration(configbd. Build()) 
,UseKestrel( ) 
.UseContentRoot(Directory. GetCurrentDirectory( )) 
.UseStartup< Startup >(); 

hostbd. Build( ). Run(); 


步骤 5: 打开 项 目 属性 窗口 ,切换 到 “调试 ”选项 页 。 
步骤 6: 填写 “应 用 程序 参数 ”( 即 命令 行 参数 )，。 


-— uhttp://localhost:7000 -- env Test 
步骤 7: 运行 应 用 程序 ,从 控制 台 的 输出 信息 中 可 以 查看 以 上 命令 行 参数 是 否 已 成 功 应 用 。 
实例 374 ”使 用 内 存 中 的 配置 源 


【导语 】 
配置 数据 不 仅 可 以 来 源 于 命令 行 参数 .JSON 文件 ,环境 变量 等 渠道 ,还 可 以 来 自 内 存 
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中 的 对 象 , 其 实质 是 一 个 字典 实例 。 内 存 配置 比较 适用 于 在 应 用 程序 运行 过 程 中 使 用 的 并 
上 且 不 需要 经 常 修改 的 内 容 。 

【操作 流程 】 

步骤 1: 新建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 在 Main 方法 中 创建 一 个 字典 实例 ,并 填充 初始 化 数据 。 


var data = new Dictionary< string, string> 

{ 
["environment"] = "Debug", 
["urls"] = "http://localhost:990", 
["contentRoot"] = Directory.GetCurrentDirectory(), 


于 


本 实例 共 进 行 了 三 项 配置 : 应 用 程序 的 运行 环境 、Web 服务 器 监听 请 求 的 URL 和 应 
用 程序 内 容 的 根 目录 。 
步骤 3: 使 用 ConfigurationBuilder 类 添加 内 存 配置 源 。 


var configbd = new ConfigurationBuilder( ) 
. AddInMemoryCollection( data); 


步骤 4: 使 用 内 存 配 置 初始 化 WebHost 实例 。 


var webhostbd = new WebHostBuilder() 
.UseKestrel() 
.UseConfiguration(configbd.Build()) 
.UseStartup< Startup >(); 

webhostbd. Build( ). Run(); 


步骤 5: 在 Startup 类 中 添加 并 开启 MVC 功能 。 


public void ConfigureServices(IServiceCollection services) 
{ 
services. AddMvc( ); 


} 


public void Configure( IApplicationBuilder app, IHostingEnvironment env) 
{ 
if (env. IsDevelopment()) 
{ 
app. UseDeveloperExceptionPage( ); 
} 


app. UseMvc(); 
} 


步骤 6: 在 项 目 目录 下 新 建 一 个 Pages 目录 ,并 在 Pages 目录 下 添加 一 个 Razor 文件 ， 
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命名 为 Index。 


@page "/" 
@using Microsoft. Extensions. Configuration 
@ inject IConfiguration config 
<! DOCTYPE htm] > 
<html> 
<head> 
<meta charset = "utf — 8" /> 
<title>@config[ "applicationName" ]</title> 
</head> 
<body> 
<p> 应 用 程序 名 称 :@config[ "applicationName" ]</p> 
< p> 运行 环境 :@config["environment"]</p> 
< p> 监听 URL:@config["urls"]</p> 
</body> 
</htnl > 


该 页 面 的 作用 是 输出 三 个 配置 项 。 在 页 而 顶部 ,通过 @inject 指令 可 以 接收 
IConfiguration 类 型 的 依赖 注入 (在 构建 WebHost 对 象 的 过 程 中 ,应 用 程序 会 将 
IConfiguration 注册 到 服务 容器 内 )。 在 配置 数据 中 ,urls 和 environment 是 在 内 存 配 置 源 中 产 
生 的 ,而 applicationName 则 由 应 用 程序 自动 配置 的 ,一 般 是 当前 应 用 程序 的 程序 集 名 称 。 

步骤 7: 运行 应 用 程序 ,结果 如 图 17-3 所 示 。 


= EE 


€ OO © localhost:990/ 去 


应 用 程序 名 称 : Demo 
运行 环境 : Debug 


监听 URL: http://localhost:990 


图 17-3 在 页 面 上 显示 配置 信息 


17.2 选项 类 


实例 375 ”选项 类 的 使 用 方法 

【导语 】 

选项 类 本 质 上 就 是 常见 的 类 (class) ,通常 它 会 公开 一 些 属性 ,用 来 读 写 相 关 的 选项 。 
框架 内 部 也 定义 了 许多 选项 类 (选项 类 的 命名 一 般 会 以 Options 结尾 ), 例如 
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RazorPagesOptions 类 可 用 于 设置 与 Razor 页 面相 关 的 参数 , 它 的 RootDirectory 属性 可 以 
设置 查找 页 面 的 根 目录 ,默认 为 /Pages。 

定义 选项 类 之 后 ,需要 在 ConfigureServices 方法 中 将 其 注册 到 服务 容器 内 。 选 项 类 的 
作用 是 进行 配置 ,区 别 于 一 般 的 服务 类 型 ,因此 在 接收 依赖 注入 时 ,应 当先 选用 IOptions 
<TOptions > 类 型 来 接收 对 象 的 引用 ,再 从 实例 的 Value 属性 中 获得 选项 类 的 实例 。 

【操作 流程 】 

步骤 1: 创建 一 个 月 定义 的 选项 类 ,本 实例 中 将 其 命名 为 DemoOptions, 它 有 三 个 公共 属性 。 


public class DemoOptions 

{ 
public string OptionA { get; set; } 
public string OptionB { get; set; } 
public string OptionC { get; set; } 

3} 


步骤 2: 在 Startup. ConfigureServices 方法 中 将 选项 类 注册 到 服务 容器 内 。 


public void ConfigureServices(IServiceCollection services) 
{ 
services. AddMvc( ); 
services. Configure < DemoOptions >(o => 
{ 
o.0ptionA = "选项 1"; 
0.0ptionB = "选项 2"; 
o.0ptionC = "选项 3"; 
DD); 
} 


Configure < TOptions > 方法 可 以 通过 一 个 委托 对 象 来 初始 化 DemoOptions 选项 类 的 
属性 。 

步骤 3: 在 项 目 目录 下 创建 一 个 Pages 目录 ,然后 在 Pages 目录 下 添加 一 个 test 页 面 。 

步骤 4: 在 Razor 文件 中 ,使 用 @inject 指令 来 接收 选项 类 的 注入 。 

@inject IOptions < Demo0ptions > opt 


步骤 5: 获取 DemoOptions 实例 的 引用 。 


@!{ 
DemoOptions doption = opt?. Value; 


} 
步骤 6: 在 页 面 上 显示 DemoOptions 选项 类 的 各 个 属性 的 值 。 


@if(doption != null) 
{ 
<p>@string. Format("{0} : {1}", nameof(doption. OptionA), doption. OptionA)</p> 
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<p>@string. Format("{0} : {1}", nameof(doption. OptionB), doption. OptionB)</p> 
<p>@string. Format("{0} : {1}", nameof(doption. OptionC), doption. OptionC)</p> 
} 
else 
{ 
<p> 暂 无 选项 信息 </p> 
} 


步骤 7: 运行 应 用 程序 ,结果 如 图 17-4 所 示 。 


《4 OO 加 localhost:7626/ 六 


| OptionA : 选项 1 


OptionB : 选项 2 
| OptionC : 选项 3 


L 


图 17-4 输出 选项 类 的 属性 值 


实例 376 ”使 用 JSON 文件 来 配置 选项 类 


【导语 】 

初始 化 选项 类 最 简单 的 方法 ,是 在 调用 Configure < TOptions > 方法 时 通过 传人 的 委托 
对 象 来 设置 各 个 属性 的 值 ,该 方法 的 缺点 是 如 果 需 要 经 常 修改 选项 类 的 数据 的 话 ,在 每 次 更 
新 属性 后 都 要 重新 编译 应 用 程序 。 而 使 用 JSON 文件 来 配置 选项 类 的 初始 数据 是 一 种 比较 
实用 的 方案 , 当 要 进行 更 新 时 ,只 需 修改 JSON 文件 中 的 内 容 , 可 以 免 去 重新 编译 和 发 布 应 
用 程序 的 麻烦 。 

使 用 JSON 文件 配置 时 ,首先 使 用 ConfigurationBuilder 类 添加 JSON 文件 配置 源 。 然 
后 调用 Build 方法 生成 配置 信息 ,可 以 在 配置 WebHostBuilder 时 通过 UseConfiguration 方 
法 应 用 配置 信息 ,再 经 过 依赖 注入 提供 给 Startup 类 。 最 后 在 ConfigureServices 方法 中 调 
用 Configure < TOptions > 方法 ,并且 传 递 配 置信 息 来 初始 化 选项 类 。 
从 JSON 文件 中 提取 选项 类 的 属性 值 , 实 质 上 是 一 个 反 序 列 化 的 过 程 , 这 就 要 求 JSON 
文件 中 的 字段 名 称 必须 与 选项 类 的 属性 名 称 匹配 (字段 名 称 的 首 字母 允许 使 用 小 写 ) 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 定义 选项 类 TestOptions ,公开 两 个 string 类 型 的 属性 Iteml 和 Item2 。 


public class TestOptions 
{ 
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public string Iteml { get; set; } 
public string Item2 { get; set; } 
} 


步骤 3: 在 项 目 目录 下 添加 一 个 JSON 文件 ,命名 为 configs. json。 
{ 


"urls": "http://localhost:16420", 
"environment": "Development", 
"myOptions": { 

"iteml": "选项 一 A"， 

"item2": "选项 - B" 


} 
urls 和 environment 两 个 字段 配置 的 是 WebHost, myOptions 字段 中 所 包含 的 内 容 才 
是 配置 TestOptions 选项 类 的 。 


步骤 4: 在 Main 方法 中 ,创建 并 启动 WebHost 实例 ,并 且 加 载 configs. json 文件 中 的 
配置 内 容 。 


var config = new ConfigurationBuilder() 
. SetBasePath(DirectorV. GetCurrentDirectory()) 
.AddJsonFile( "configs. json"，optional:true) 
.Build(); 

var host = new WebHostBuilder() 
.UseKestrel() 
.UseContentRoot (Directory. GetCurrentDirectory( )) 
.UseConfiguration(config) 
.UseStartup< Startup >() 
,Build() 7 

host. Run( ); 


AddJsonFile 扩展 方法 的 optional 参数 用 于 指定 当前 要 添加 的 配置 源 是 否 为 可 选 。 本 
实例 中 将 该 参数 设置 为 true, 如 果 应 用 程序 找 不 到 configs. json 文件 ,就 忽略 它 , 不 会 发 生 
异常 。 

步骤 5: 修改 项 目 模板 默认 生成 的 Startup 类 ,从 构造 函数 中 接收 IConfiguration 类 型 
的 参数 ,以 便 获 得 配置 信息 的 引用 。 


private readonly IHostingEnvironment _env; 

private readonly IConfiguration config; 

public Startup(IHostingEnvironment env, IConfiguration config) 
_env = env; 


_config = config; 
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步骤 6: 在 ConfigureServices 方法 中 调用 Configure < TOptions > 方法 来 初始 化 


TestOptions 选项 类 ,之 后 它 会 注册 到 服务 容器 中 。 


public void ConfigureServices(IServiceCollection services) 


{ 


services. AddMvc( ); 


services. Configure < TestOptions >(_config. GetSection("myOptions" ) ) ; 


} 


由 于 在 configs. json 文件 中 ,myOptions 字段 所 包含 的 内 容 才 是 反 序 列 化 TestOptions 
类 所 需要 的 ,所 以 这 里 要 调用 GetSection 方法 获取 myOptions 字段 下 的 内 容 。 
步骤 7: 创建 Demo 控制 器 ,返回 一 个 视图 ,用 于 显示 选项 类 的 信息 。 


[Route("opts/[action]")] 
public class DemoController : 


{ 
! 


Controller 


public ActionResult Default() => View(); 


步骤 8: Default 视图 的 内 容 如 下 。 


@using Microsoft. Extensions. Options 
@using Demo 
@ inject IOptions < TestOptions> opt 


<html> 
<body> 
@!{ 
TestOptions o = opt?.Value; 
} 
@if(o == null) 
{ 
< div> 无 选项 信息 。</div> 
} 


else 
{ 
<div> 
<p> Item 1 : @o. Iteml </p> 
<p> Item 2 : @o. Item2 </p> 
</div> 
} 
</body> 
</htnl > 


步骤 9: 运行 应 用 程序 ,在 浏览 器 中 访问 http: 
//localhost: 16420/opts/default, 可 以 看 到 选项 类 初 
始 化 后 的 属性 值 , 如 图 17-5 所 示 。 


回 locah x 


SR 


O localhostl642ok 门 广 


Item 1 : 选项 -A 


Item 2 : 选项 -B 


图 17-5 选项 类 的 初始 状态 
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注意 : 如 果 JSON 文件 中 包含 中 文字 符 , 在 应 用 程序 中 加 载 后 可 能 会 出 现 乱 码 ,将 JSON 文 
件 以 UTF-8 编码 重新 保存 , 即 可 解决 问题 。 


17.3 实体 框架 


实例 377 为 实体 模型 设置 主键 


【导语 】 

实体 模型 会 映射 到 数据 库 中 的 表 , 而 数据 表 中 通常 需要 一 个 可 以 唯一 标识 每 条 记录 的 
字段 ,所 以 在 一 个 实体 类 中 ,应 该 至 少 选 择 一 个 属性 作为 主键 。 在 实体 类 中 设置 主键 有 三 种 

(1) 将 类 中 的 某 个 属性 命名 为 Id 或 者 < 类 名 十 Id >, 会 被 自动 识别 为 主键 。 例 如 , 某 实 
体 类 命名 为 Student, 那 么 如 果 该 类 中 存在 命名 为 Id 或 者 StudentId 的 属性 ,就 可 以 将 其 自 
动 识 别 为 Student 实体 的 主键 。 

(2) 通过 数据 批注 来 指定 。 数 据 批注 本 质 是 特性 (Attribute) , 即 用 于 标注 实体 类 或 其 
成 员 上 的 特性 。 将 一 个 或 多 个 属性 标注 为 主键 可 以 应 用 Key 特性 (KeyAttribute 类 ) 。 

(3) 从 DbContext 类 派生 后 ,可 以 重 写 OnModelCreating 方法 ,再 通过 调用 HasKey 方 


法 来 设置 要 作为 主键 的 属性 。 
本 实例 将 分 别 对 以 上 三 种 方法 进行 演示 。 
【操作 流程 】 


步骤 1: 新建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 
步骤 2: 声明 实体 类 Car, 将 作为 主键 的 属性 命名 为 Carld, 它 会 自动 被 识别 为 主键 。 


public class Car 

{ 
public int CarId { get; set; } 
public string Color { get; set; } 


} 
步骤 3: 声明 Employee 实体 类 ,使 用 Key 特性 标注 主键 。 


public class Employee 
{ 
[Key] 
public int EmpIdentity { get; set; } 
public int EmpAge { get; set; } 
public string EnpName { get; set; } 
} 


步骤 4: 声明 Activity 实体 类 ,无 须 应 用 特性 , 稍 后 会 在 从 DbContext 类 派生 的 子 类 中 
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public class Activity 
{ 
public Guid ActFlag { get; set; } 
public TimeSpan Period { get; set; } 
} 


步骤 $: 从 DbContext 类 中 派生 出 一 个 数据 上 下 文 类 型 ,将 上 而 定义 的 三 个 实体 分 别 
作为 公共 属性 公开 ,类 型 为 DbSet < TEntity >, 此 处 TEntity 为 具体 的 实体 类 型 。 


public class MYDbContext : DbContext 
{ 


public DbSet < Car > Cars { get; set; } 

public DbSet < Employee > Employees { get; set; } 

public DbSet < Activity> Activities { get; set; } 
} 


步骤 6: 重 写 OnModelCreating 方法 ,为 Activity 实体 设置 主键 。 


protected override void OnModelCreating(ModelBuilder nodelBuilder) 
// 设置 Activity 类 的 ActFlag 属性 为 主键 
modelBuilder. Entity < Activity>().Haskey(nameof (Activity. ActFlag)); 


} 

实例 378 ”迁移 实体 并 生成 数据 库 

【导语 】 

本 实例 将 演示 在 Visual Studio 开发 环境 中 使 用 Nuget 控制 台 命令 来 根据 实体 模型 生 
成 数据 库 的 过 程 。 


要 查看 EntityFramework Core(EF Core) 工 具 集中 提供 的 命令 说 明 , 可 以 在 Nuget 控 
制 台 窗 口中 输入 如 下 命令 行 : 

get 一 help about EntityFrameworkCore 
会 得 到 如 图 17-6 所 示 的 帮助 信息 。 

要 根据 已 编写 好 的 代码 (实体 类 以 及 从 DbContext 类 派生 的 自 定 义 数 据 上 下 文 ) 生 成 
迁移 代码 (创建 数据 库 前 需要 迁移 代码 ) ,请 使 用 Add-Migration 命令 ,用 法 如 下 : 

add- Migration [ - Name] < String> [ - OutputDir < String>] [ - Context < String>] [ - Project 

< String>] [ - StartupProject < String>] 

(1) -Name 参数 为 生成 的 迁移 版 本 指定 一 个 名 称 ,此 名 称 可 以 自 定义 ,-Name 可 以 省 
略 , 即 可 以 直接 在 首 个 参数 的 位 置 写 上 迁移 版 本 的 名 称 , 例 如 Add-Migration“Test”, 其 中 
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Demo 


about_EntityFrameworkCore 


SHORT DES( ION 
Provides information about the Entity Framework Core Package Manager Console Tools. 


LONG DESCRIPTION 
This topic describes the Entity Framework Core Package Manager Console Tools. See https://docs.efproject, net for 
information on Entity Framework Core. 


The following Entity Framework Core commands are available. 


Cmdlet 


Add -Migration Adds a new migration. 


Drop -Database Drops the database 

Get text Gets information about a DbContext type. 
Remove-Migration Removes the last migration. 

Scaffold-DbContext Scaffolds a DbContext and entity types for a database. 


Script -Migration Generates a SQL script from migrations. 


图 17-6 ”EF Core 帮助 文档 


“Test” 就 是 生成 的 迁移 版 本 的 名 称 。 

(2) -OutputDir 参数 指定 生成 的 代码 文件 所 保存 的 目录 ,该 目录 的 路 径 是 相对 于 项 目 
根 目录 的 。 此 参数 可 以 忽略 ,如 果 不 指定 ,默认 生成 的 目录 名 为 "Migrations”。 

(3) -Context 参数 指定 要 使 用 的 数据 上 下 文 , 即 从 DbContext 类 派生 的 子 类 名 称 。 

(4) -Project 参数 表示 要 使 用 的 应 用 程序 项 目 , 可 以 忽略 ,一 般 是 当前 项 目 。 

(5) -StartupProject 参数 指定 当前 解决 方案 中 的 启动 项 目 。 此 参数 可 以 忽略 ,使 用 与 
解决 方案 配置 相同 的 启动 项 目 。 

假设 数据 上 下 文 的 类 型 名 称 为 CustDbContext, 以 下 命令 将 在 项 目的 CustMigVers 目 
录 下 生成 名 为 “Init” 的 迁移 代码 。 


Add — Migration "Init" ~ OutputDir "CustMigVers" - Context "CustDbContext" 


Add-Migration 命令 所 生成 的 迁移 代码 是 会 自动 积累 的 。 例 如 ,编写 完 相 关 实 体 和 数 
据 上 下 文 代码 后 ,执行 了 一 次 该 命令 ,生成 了 名 为 “MG 1” 的 迁移 代码 ; 之 后 由 于 项 目 需求 ， 
对 实体 进行 了 更 改 , 实 体 类 增加 了 属性 ,于 是 需要 再 次 执行 Add-Migration 命令 生成 最 新 的 
迁移 代码 ,假设 第 二 次 生成 的 迁移 代码 名 为 “MG 2”; 最 终 ,“MG 1? 的 迁移 代码 不 会 被 删 
除 ,“MG 2? 仅 在 “MG 1” 的 基础 上 进行 修订 。 
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当然 ,如 果实 体 类 型 的 代码 被 大 面积 修改 (新 增 或 删除 类 型 等 ) ,就 会 考虑 把 先前 的 迁移 
版 本 删除 ,并 重新 生成 迁移 代码 。 此 时 可 以 使 用 Remove-Migration 命令 ,但 该 命令 不 会 一 
次 性 删除 所 有 迁移 (一 次 性 删除 容易 造成 误 删 ) ,每 执行 一 次 Remove-Migration 命令 ,只 会 
删除 最 新 的 一 个 迁移 版 本 。Remove-Migration 命令 用 法 如 下 : 


Remove — Migration [ — Force] [ - Context < String >] [ - Project < String >] [ - StartupProject 
< String>] 
(1) -Force 参数 可 选 , 如 果 迁 移 代 码 已 经 应 用 到 数据 库 , 可 以 将 其 进行 回 滚 。 
(2) -Context 参数 表示 要 使 用 的 数据 上 下 文 类 型 。 
(3) -Project 参数 与 -StartupProject 参数 的 功能 与 Add-Migration 命令 相同 。 
生成 迁移 代码 后 ,就 可 以 使 用 Update-Database 命令 来 生成 /更 新 数据 库 。Update-Database 
命令 用 法 如 下 : 
Update - Database [[ - Migration] < String >] [ - Context < String >] [ - Project < String >] 
[— StartupProject < String>] 
-Migration 参数 (参数 名 可 以 省 略 ) 指 定 要 应 用 到 数据 库 的 迁移 名 称 , 如 果 不 指定 ,将 应 用 所 
有 迁移 版 本 来 更 新 数据 库 。 删 除数 据 库 可 以 使 用 Drop-Database 命令 。 
【操作 流程 】 
步骤 1: 创建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 
步骤 2: 定义 实体 类 ,命名 为 User。 


public class User 

{ 
public int UID { get; set; } 
[Required(ErrorMessage = "用 户 名 是 必 填 项 ")] 
public string UserName { get; set; } 
[DataType(DataType. Password) ] 
public string Password { get; set; } 
public bool IsAdmin { get; set; } 

’ 


UID 属性 将 作为 主键 ,其 值 由 数据 库 自动 生成 ,创建 新 实例 时 无 须 赋值 。Required 特 
性 指定 UserName 属性 为 必 填 项 , 当 在 视图 页 面 上 未 输入 有 效 的 用 户 名 时 ,将 无 法 通过 
验证 。 

步骤 3: 从 DbContext 类 派生 一 个 子 类 ,并 将 User 实体 作为 数据 集合 公开 。 

public class UsContext : DbContext 

{ 


public DbSet < User > Users { get; set; } 
和 
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步骤 4: 重 写 DbContext 类 的 OnModelCreating 方法 ,并 设置 UID 属性 为 主键 。 


public class UsContext : DbContext 
i 


protected override void OnModelCreating(ModelBuilder modelBuilder) 
{ 


modelBuilder. Entity < User >(). HasKey(u => u.UID); 
} 
} 


步骤 5: 重 写 OnConfiguring 方法 ,配置 SQL Server 连接 字符 串 。 


public class UsContext : DbContext 
{ 


protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder) 
{ 
optionsBuilder, UseSqlServer("server = (localdb)\\MSSQLLocalDB; database = CustDB" ) ; 
} 
} 


本 实例 使 用 的 是 轻 量 级 的 SQL Server LocalDB, 默认 的 引擎 实例 名 称 为 
“MSSQLLocalDB”, 可 以 通过 “(localdb)\\MSSQLLocalDB” 来 连接 服务 器 。 

步骤 6: 在 Startup. ConfigureServices 方法 中 将 自 定义 的 UsContext 类 注册 到 服务 容 
器 中 。 

public void ConfigureServices(IServiceCollection services) 

{ 


services. AddMvc( ); 
services. AddDbContext < UsContext >(); 


} 


步骤 7: 打开 Nuget 软件 包 管理 器 的 控制 台 窗 口 ,输入 以 下 命令 为 UsContext 数据 上 
下 文 创建 一 个 迁移 版 本 。 


add — migration "ver 1" ~ OutputDir "MyMigras" - Context "UsContext" 


该 迁移 的 名 称 为 "ver 1”, 生 成 代码 的 输出 目录 是 项 目 根 目录 下 的 MyMigras 文件 夹 。 
步骤 8: 输入 以 下 命令 创建 数据 库 。 


update — database 


步骤 9: 定义 一 个 控制 器 ,用 于 查看 .新 增 和 删除 数据 , 详 见 代码 清单 17-1。 
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代码 清单 17-1 ”Home 控制 器 代码 


public class HomeController : Controller 
{ 
private readonly UsContext _context; 
public HomeController(UsContext cxt) 


Contexst = Cxts 


public ActionResult UserList() 


return View("default", _context. Users. ToList()); 


public ActionResult PostUser(User user) 


if (ModelState. IsValid) 

{ 
_context. Users. Add( user); 
_context. SaveChanges(); 

} 


return View("default", _context. Users. ToList()); 


public ActionResult DeleteUser( int uid) 
{ 


User u = (fromus in _context.Users 
where us.UID == uid 
select us). FirstOrDefault(); 
证 (ul= null) 


_context. Users. Renove( u); 
_context. SaveChanges(); 
} 


return View("default", _context. Users. ToList()); 


步骤 10: 新 建 default 视图 ,用 于 展示 数据 记录 。 


@model List<User> 


<html> 


<body> 
<div class= "container"> 
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<div> 
@await Component. InvokeAsync ("NewUser") 
</div> 
<hr /> 
<div> 
@if (Model == null || Model.Count == 0) 
{ 
<p> 无 用 户 信息 </p> 
} 
else 
{ 
foreach (User us in Model) 
{ 
<p> 
用 户 ID:@us.UID<br /> 
用 户 名 :@us. UserName < br /> 
管理 员 :@(us. Ishdmin ? "是 " : " 否 ")< br /> 
<aasp-controller = "Home" asp— action = "DeleteUser" asp— route 一 
uid = "@us.UID"> 删 除 </a> 
</p> 
} 
} 
</div> 
</div> 
</body> 
</htnl > 


Model 是 从 控制 器 传递 进来 的 User 实例 列表 ,在 视图 中 通过 foreach 循环 显示 每 个 
User 实 例 的 信息 。 其 中 < a > 元 素 用 于 执行 删除 操作 ,调用 的 是 控制 器 的 DeleteUser 方法 。 

步骤 11: 上 述 视图 中 引用 了 一 个 视图 组 件 , 用 于 新 增 User 信息 。NewUser 视图 组 件 
的 具体 代码 如 下 。 


public class NewUserViewComponent : ViewConponent 
{ 
public IViewComponentResult Invoke() 
E 
return View("addUser", new User()); 


} 


注意 : 视图 组 件 所 关联 的 视图 会 合并 到 引用 它 的 视图 中 , 主 视图 中 指定 的 Model 是 User 对 
象 的 列表 ,而 视图 组 件 中 指定 的 Model 是 单个 User 实例 。 所 以 在 调用 视图 组 件 的 
View 方法 时 ,除了 指定 视图 名 称 外 ,还 要 传递 一 个 新 的 User 实例 作为 Model, 避 免 
ViewState 对 象 把 主 视 图 的 List< User > 传递 给 addUser 视图 的 Model 而 导致 类 型 
不 匹配 。 
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步骤 12: 以 下 为 addUser 视图 的 内 容 。 


@model User 
< form asp — controller = "Home" asp— action = "PostUser"> 
<div class = "form— group"> 
< label > 用 户 名 :</label > 
< input asp- for = "UserName" class = "form - control" /> 
< span asp - validation— for = "UserName"></span> 
</div> 
<div class = "form— group"> 
< label > 密码 :</label > 
< input asp- for = "Password" class = "form— control" /> 
</div> 
<div class= "form— check"> 
< input asp- for = "IsAdmin" class= "form- check - input" /> 
< label class = "form- check- label"> 此 用 户 是 管理 员 </label > 
</div> 
< button type = "submit" class = "btn btn - primary"> 创 建新 用 户 </button> 


</form> 


步骤 13: 运行 应 用 程序 ,最 终 效果 如 图 17-7 所 示 。 


加 localhost x 


Eo © localhost:14612/Home/PostUser 六 去 由 四 几 
户 名 : 


此 用 户 是 管理 员 


户 ID: 25 

户 名 : MrLiu 
管理 员 : 是 
删除 


图 17-7 User 对 象 列 表 视 图 
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步骤 14: 实例 中 所 创建 的 数据 库 一般 用 于 测试 , 当 不 再 需要 该 数据 库 时 ,可 以 在 Nuget 
控制 台中 输入 Drop-Database 命令 来 删除 。 


drop - database 


实例 379 ”内存 数 据 库 


【导语 】 

内 存 数据 库 仅 存储 于 内 存 区 域 , 它 不 会 长 久 地 保存 数据 ,因此 内 存 数据 库 比 较 适 合 存储 
应 用 程序 运行 期 间 的 一 些 临时 数据 。 

【操作 流程 】 

步骤 1: 新 建 一 个 空白 的 ASP. NET Core Web 项 目 。 

步骤 2: 定义 实体 类 。 

Ppublic class TestEnt 

{ 

public Guid AutoID { get; set; } 


public byte[ ] RandData { get; set; } 
} 


步骤 3: 自 定义 一 个 从 DbContext 派生 的 子 类 。 


public class MyDbContext :DbContext 
{ 
public MyDbContext (DbContextOptions < MyDbContext > opt) 
: base(opt) 
{ 


} 
public DbSet < TestEnt > TestEnts { get; set; } 


protected override void OnModelCreating(ModelBuilder modelBuilder) 
{ 
modelBuilder. Entity < TestEnt >().HasKey(nameof (TestEnt. AutoID)); 
} 
} 


实体 类 的 AutoID 属性 将 作为 数据 表 的 主键 。 
步骤 4: 在 Startup. ConfigureServices 方法 中 注册 上 述 自 定义 的 DbContext 类 ,并 且 启 
用 内 存 数据 库 。 


public void ConfigureServices( IServiceCollection services) 


{ 


services. AddMvc( ); 
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services. RddDbContext < MyDbContext >(o => 


{ 
0.UseInMemoryDatabase("deno_db"); 


D); 
} 


“demo_db” 是 内 存 数据 库 的 名 字 , 该 名 字 可 以 自 定义 。 
步骤 5: 在 Main 方法 中 通过 WebHostBuilder 创建 WebHost 实例 。 


var host = new WebHostBuilder() 
.UseEnvironment (EnvironmentNane. Development) 
.UseKestrel() 
.UseContentRoot (Directory. GetCurrentDirectory( )) 
.UseUrls("http://localhost:6910") 
.UseStartup< Startup >() 
.Build(); 


步骤 6: 在 调用 Run 方法 之 前 ,通过 以 下 代码 对 内 存 数据 库 进 行 初始 化 。 


using (IServiceScope scope = host.Services. CreateScope()) 
{ 
MyDbContext context = scope. ServiceProvider.GetRequiredService< MyDbContext >(); 
Random rand = new Random(); 
for (int x = 0; x<5; x++) 
byte[ ] buffer = new byte[15]; 
rand. NextBytes(buffer); 
context. TestEnts. Add( new TestEnt 
芝 
RandData = buffer 
D); 
} 
context. SaveChanges( ); 


} 


CreateScope 方法 可 以 返回 一 个 临时 对 和 象 的 引用 ,随后 通过 临时 对 象 创建 的 服务 实例 的 
生命 周期 将 在 此 scope 变量 的 作用 域 之 内 。 此 方案 可 以 临时 创建 MyDbContext 实例 来 写 
和 初始 化 数据 ,随后 MyDbContext 实例 就 会 被 释放 。 

步骤 7: 调用 Run 方法 来 启动 Web 服务 主机 。 


host. Run( ); 


步骤 8: 定义 一 个 Web API 控制 器 ,用 于 返回 内 存 数据 库 中 的 内 容 。 


[Route("[controller]")] 
public class DemoController : Controller 
{ 

private readonly MyDbContext context; 
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public DemoController(MYDbContext c) 
{ 
Context = c; 


} 


[HttpGet] 
public ActionResult Get() 
{ 


return Json(context. TestEnts); 


} 


步骤 9: 运行 应 用 程序 ,以 HTTP-GET 方式 请 求 地 址 http: //localhost: 6910/demo 
将 返回 以 下 数据 。 


"autoID": "e3dl9b6a — cd52— 461c — 896b — e321a3b92064", 
"randData" : "yBDvZH2BdNc86fvOJxrd" 
}, 


"autoID": "86b20299 — 6e0f — 4137 - bb2b — 6a93dalcbd44", 
"randData" : "BoDt17s4vP4oR1XHgfe4" 


"autoID" : "04f8d983 - 5abl - 434a - bbla - £3678d5fa179", 
"randData" : "8e9jESSzfrJeCgstURP2" 
} 


"autoID" : "74a35966 — 9d34— 4754 一 ac52 — 0cc2f085010b"， 


"randData" : "8oKnCay3WKtsRAwRxmEo" 


"autoID": "fa838290 - 228c — 4374 - 9b6a — 78bf7dfb9398", 
"randData" : "uvLghPcLKBX1KYjOjoyw" 


] 
实例 380 ”在 应 用 程序 运行 期 间 创 建 SQLite 数据 库 
【导语 】 


为 实体 模型 创建 数据 库 有 两 种 方案 : 中 在 Nuget 控制 台中 执行 Update-Database 命令 
(或 者 在 命令 行 中 执行 dotnet ef database update 命令 ) ,此 方案 是 在 应 用 程序 未 运行 的 情况 
下 执行 的 ; @ 通 过 编写 代码 ,在 应 用 程序 运行 期 间 创 建 数据 库 。 

DbContext 类 公开 了 Database 属性 ,其 类 型 为 DatabaseFacade, 该 类 型 公开 了 用 了 


让 


在 
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运行 阶段 创建 和 删除 数据 库 的 方法 。 

(1) EnsureCreated 方法 或 EnsureCreatedAsync 方法 。 如 果 目 标 数 据 库 ( 根 据 连接 字 
符 串 获得 ) 不 存在 ,就 创建 新 数据 库 并 返回 true; 如 果 数 据 库 已 经 存在 , 则 返回 false。 

(2) EnsureDeleted 方法 或 EnsureDeletedAsync 方法 。 如 果 目 标 数据 库 已 存在 , 则 删 
除 该 数据 库 并 返回 true, 否 则 返回 false。 

本 实例 演示 了 在 应 用 程序 运行 过 程 中 通过 调用 代码 来 创建 SQLite 数据 库 。 

【操作 流程 】 

步骤 1: 创建 一 个 空白 的 ASP. NET Core Web 应 用 程序 项 目 。 

步骤 2: 打开 Nuget 控制 台 窗 口 ,输入 以 下 命令 来 安装 SQLite 数据 库 提供 的 与 程序 相 
关 的 程序 包 。 


Install - Package Microsoft. EntityFrameworkCore. Sqlite 


从 .NET Core SDK 2. 1 开始 ,此 程序 包 并 不 在 AspNetCore. App 默认 包含 的 程序 包 列 
表 中 ,需要 手动 安装 。 
步骤 3: 定义 两 个 实体 类 


public class Album 


i 
public int ID { get; set; } 
public string AlbumName { get; set; } 
public int Year { get; set; } 
public string Summary { get; set; } 
public List < Track > Tracks { get; set; } 
} 


public class Track 
{ 
public int ID { get; set; } 
public string Title { get; set; } 
public string Artist { get; set; } 
public double Duration { get; set; } 
} 


步骤 4: 定义 DbContext 的 派生 类 。 


public class DemoDbContext : DbContext 

{ 
public DbSet < Album > Albums { get; set; } 
public DbSet < Track > Tracks { get; set; } 


protected override void OnModelCreating(ModelBuilder modelBuilder) 
{ 

// 配置 主键 

modelBuilder.Entity< hlbun >(). HasKey(s => s.ID); 
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modelBuilder.Entity< Track>().HasKey(t => t.1D); 

// 配置 为 一 对 多 的 关系 

modelBuilder. Entity< Albun>().HasMany(a => a.Tracks). Withone(); 
} 


protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder) 
{ 
optionsBuilder. UseSqlite( "data source = TestData. db"); 
} 
} 


在 OnModelCreating 方法 中 ,首先 分 别 设置 两 个 实体 的 主键 ,然后 配置 两 个 实体 之 间 
的 关系 : Album 类 与 Track 类 是 “一 对 多 ”的 关系 。 
步骤 5: 在 Main 方法 中 ,配置 并 创建 WebHost 实例 。 


var host = new WebHostBuilder() 
.UseKestrel() 
.UseEnvironment (EnvironmentNane. Development) 
.UseContentRoot (Directory. GetCurrentDirectory( )) 
.UseUrls("http://localhost:9133") 
.UseStartup< Startup >() 
.Build(); 


步骤 6: 为 了 生成 测试 用 的 数据 ,在 运行 WebHost 实例 前 ,可 以 先 创 建 数据 库 , 然 后 再 
向 数据 库 写 和 记录。 


using(IServiceScope scope = host.Services.CreateScope()) 
{ 
DemoDbContext context = scope.ServiceProvider.GetRequiredService < DemoDbContext >(); 
context. Database. EnsureDeleted( ); 
if (context. Database. EnsureCreated( )) 
{ 
// 如 果 是 新 创建 的 数据 库 , 写 人 一 些 测试 数据 
Album abl = new Rlbum(); 
abl.AlbumName = "专辑 01"; 
abl. Year = 2010; 
abl. Sunmary = "冬日 里 的 唱 响 "; 
abl. Tracks = new List< Track> 
{ 
new Track 
Title = "曲目 1"， 
Artist = " 老 高 "， 
Duration = 212.3d 
}, 
new Track 


和 
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Title = "曲目 2"， 
Artist =“" 大 胶 "， 
Duration = 179.62d 
} 
}; 
context. Albums, add(abl) 7 
Album ab2 = new Album(); 
ab2. AlbumName = "专辑 02"; 
ab2. Year = 2016; 
ab2. Summary = "最 具 风 雅 的 弦 乐 "; 
ab2. Tracks = new List< Track> 
{ 
new Track 
{ 
Title = "曲目 1" 
Artist = " 张 K"， 
Duration = 230.301d 
] 
new Track 
Title = "曲目 2"， 
Artist = "Coh", 
Duration = 197d 
}, 
new Track 
{ 
Title = "曲目 3"v 
Artist = "L.Joke", 
Duration = 265.99d 
} 
}; 
context. Albums. Add(ab2); 
context. SaveChanges( ); 


} 


先 调用 EnsureDeleted 方法 以 确保 删除 已 有 的 数据 库 , 再 调用 EnsureCreated 方法 创建 
新 的 数据 库 。 
步骤 7: 创建 一 个 API 控制 器 ,返回 Album 实体 列表 (JSON 格式 )。 


[Route("albums") ] 

public class DemoController : Controller 

{ 
readonly DemoDbContext context; 
public DemoController(DemoDbContext cxt) 
{ 


context = cxt; 
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} 
[HttpGet] 
public ActionResult Get() 
{ 
var albums = context.Albunms. Include(a => a.Tracks); 
return Json(albums); 
} 


} 
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Album 实体 类 的 Tracks 属性 属于 “导航 属性 ”, 它 包含 与 该 实体 有 关联 的 Track 对 象 。 
这 里 必须 调用 Include 方法 ,否则 Tracks 属性 将 返回 null( 默 认 不 会 加 载 导航 属性 所 包含 的 


数据 )。 


步骤 8: 运行 应 用 程序 ,访问 地 址 http: //localhost: 9133/albums 可 获取 Album 对 象 


列表 。 返回 的 JSON 内 容 如 下 。 


[ 
{ 
"Js 
"albumName" : "专辑 01", 
"Year" : 2010, 
"summary" : "冬日 里 的 唱 响 ”， 
"tracks" : [ 
{ 
"i 
"title": "曲目 1"， 
"artist": " 老 高 "， 
"duration": 212.3 
}, 
{ 
"id 
"title": "曲目 2"， 
"artist": "大 鹏 "， 
"duration": 179.62 
} 
] 
外 
"a 
"albumName" : "专辑 02"， 
"year": 2016, 


"summary" : "最 具 风雅 的 弦 乐 "， 


"tracks": [ 
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vis 
"title": "曲目 1"， 
vartist":" 张 K"， 


"duration": 230.301 


"vid": 4, 
"title": "曲目 2"， 
"aetigt”s “Co 


"duration" : 197 


“i 
"title 


"曲目 3", 
"artist" : "L. Joke", 


"duration": 265.99 


